Skip to content

NocodeMrLi/mini-program-engineering-skill-suite / skills/mini-program-project-intake-skill

mini-program-project-intake-skill

Verified

Perform a read-only, evidence-first intake of an existing mini-program repository before planning or modifying code. Use when users ask to take over, understand, audit, resume, scope, or continue a WeChat or other mini-program project; when project facts may conflict with historical documents; or when an agent needs the framework, rules, Git state, build path, risks, unknowns, protected behavior, and change boundary. Produces a project fact map and handoff without changing code, installing dependencies, building artifacts, or claiming runtime, device, cloud, upload, acceptance, or release status.

references/intake-workflow.md

View on GitHub
# 项目接管方法

## 目录

1. 根目录与规则
2. 目录画像
3. 事实分类
4. 风险与边界
5. 输出质量

## 根目录与规则

确认用户给出的目录真实存在,并从项目根向当前工作目录查找 `AGENTS.md`、`CLAUDE.md`、README、包管理和平台配置。规则文件决定可用命令、文档边界和验证方式,必须先于一般经验。路径、项目名、远端名、默认分支或文档入口失效时,按 [工作区重定位与产品转向审计](relocation-and-pivot-audit.md) 从可信父目录重新发现,并用项目配置与 Git 身份交叉确认;不要沿用旧路径猜测当前项目。

## 目录画像

优先使用 `rg --files`,保留确定性文件清单和总数,再按文件名定位页面入口、路由、组件、状态、API、云函数、测试、构建与平台配置。分类统计必须能回算到同一清单;不要按“页面数 × 常见文件数”手算总量,也不要把“清单中存在”写成“已逐文件审查”。目录画像只回答“目前有什么”,不评价功能已经可用。

## 事实分类

把发现分为四类:

- 当前事实:直接由源码、配置、版本控制或本轮平台返回证明。
- 历史记录:解释此前意图,但需要当前证据确认是否仍有效。
- 推断:由多个事实合理推出,必须标注推断依据。
- 未知项:证据不足,且可能影响范围、架构、验证或发布。

当文档与源码冲突时同时保留两者,并说明当前应采用哪个事实源以及为什么。

## 风险与边界

至少检查工作区未提交改动、生成目录与源码混淆、多个状态源、测试或构建命令缺失、外部服务、权限、隐私、平台配置和过期文档。产品定位发生实质变化时增加代码、资产/数据、远端提交、正式文档、云端/发布五向基线。改动边界应写成具体文件、模块与行为,不用“相关部分”之类模糊措辞。

## 输出质量

涉及编译、预览或交付时,先核当前源/产物/加载工程、已有工具和用户分工,判断缺的是源码修复、编译刷新、工具故障还是远端上传。启动到点击的副作用独立核验,目录隔离不证明数据隔离。

简单原生动作由助手准备准确对象、动作、预期结果及失败回报,用户已选择手动时不接管 GUI、重复导入或追加无必要包;用户不在场继续独立工作。混有未验收改动时必须隔离范围,优先已有正确来源;隔离来源、采用工具、谁编译分别决策。有效冻结产物复用,新编译重核身份与范围。

文件优先指定路径和已有正式执行记录。仅下一步直接上传/填写、原路径难找且确实减负的重要材料才考虑醒目副本,不能统一放桌面;核有效稿、同源及替代关系,不恢复已收起副本。远程交付需可用附件/链接,敏感证据不得为方便公开复制。普通进度在聊天,必要计划/证据按原项目约定归档,不额外造明日进度或未请求的交接文件。

同质量、授权与证据边界下比较操作数、寻找/切换负担、等待、调用/token 和外部请求成本;没有改善则缩小路由或用原生流程,不强加套件步骤。未取实际结果不能宣称短路径成功或量化效率提高。

## 最后操作交接与必要工作

先明确目标为效果预览、体验上传、提审或正式可用,列助手必要工程、阻塞该目标的服务/配置与用户选择的最后操作。前端可见/本地通过不证明服务开放;正式可用仍被云拒绝时先说明实际影响并继续授权内收口,需决定时给具体差异,不能先称只差上传再补关键缺项。已确认先提审后开业务则保留顺序及发布前条件,不把闭业务门一律视为禁止上传。

同范围证据有效、无相关改动/失败/实际阻断且用户选定正常主工程操作时,准备简短可复制的功能备注、同步原记录并及时交接,零额外候选导入/预览/能否上传演练。实际上传错误后针对绑定目标修复与受影响复验。用户要求助手打开/定位/获准导入时按最新分工做,不沿旧人工偏好推回长路径。

配合前区分事实回答、视觉/独立回执和实际操作;阶段允许的简单事实记负责人确认,不重复索截图或升为独立平台读回。常见操作给对象/目标,复杂配置才给必要步骤。可选报表/检查先衡量收益与维护成本,无可靠自动方式不默认增加负责人值守;必需保护缺责任/来源则保持真实阻塞并给具体方案,不擅自关闭、改风险政策或虚填覆盖。

收口覆盖本轮完整确认清单:新增或受影响的复验项给前置→普通入口→操作→可见/持久结果,分列已测/未测;原确认仍有效的项只标确认范围与复用结论,不重新展开走查步骤或要求用户再跑。通用边界清单按本轮阶段与实际风险触发,不自动变成本轮新增未测项或负责人义务;真实阻塞与必要质量门仍须保留。手机阅读时可执行摘要直接在聊天,文件用于追溯。独立Skill学习不混入业务待办;交接只列目标所需材料,无跨任务依赖不加必读或恢复已暂停工作。

连续反馈中,“原问题通过但还有其他问题”按子项处理:原通过绑定原对象、版本与确认范围,新增问题进入既有记录的独立未知项;缺细节不猜根因或宣称修复,父编号不整项通过也不整项重置。证据复用及受影响复验沿下文既有条件,不因换窗口重验全部历史。

完整清单指本轮获准范围。用户明确将非阻塞的长期观察移出最终报告时,只在原记录保留内容和真实状态,不在报告表格、步骤、未测或下一步中再次点名列出;必要接续仅给原记录入口。未明确缩小范围不擅自省略未解决项。观察实际阻断本轮目标时仍列本轮阻塞,不隐藏失败或必要质量门。接续携带最新子项反馈、原确认范围、新未知、原记录入口与当前授权,历史交付报告保留时点。只读阶段只在回复中提出子项记录建议,不实际建改记录;接续需要不增加写入授权。沿用现有记录,无持续反馈时不增设台账或确认步骤。


先筛本轮范围再写成稿,交付前核最终实际输出。例如反馈为“筛选通过;长标题问题待描述;某非阻塞观察不列”,成稿只列“筛选原范围通过、长标题未知”,接续可附原观察记录入口;不能另补该观察的行或下一步。写一句“已移出/不展开”却仍点名列出,不算遵守范围。

## 质量、推进与及时反馈

质量是核心底线:已确认的产品语义、正确性、安全、存量不变量和必要证据不能为速度让步。效率与用户可见进展同时进入计划,不以内部测试数量或方案篇幅代替交付。

- 每个实施批次用短记录明确用户可验收增量:“本批用户能看到/操作/验收什么、所在工程及普通入口、必要质量门、反馈方式”。没有界面的任务给可检查的数据、接口结果或文件,不凭空增加 UI;沿用已有执行文档,不为此另造进度文件。
- 能安全接入的功能及时进入主项目正常路径,便于开发者用已有工具普通编译、预览并反馈;真实交易/外部写入未获准时保留相应关闭门,不把它当作安全界面展示的统一阻塞。
- 隔离只解决具体风险,写明当前不能接入的原因、待补断言、最小演练及接回条件。用户尚看不到实际效果时,优先排除主入口接入阻塞,不无限追加隔离演练。
- 测试或推演前点名它解决的新增改动、风险、失败或证据缺口;已有同范围同版本合格证据复用。重复检查无新信息就停止,保留必要门禁;禁止以“更全面”为由反复全量回归、做新包或重复同一推演。
- 汇报先说明新增可验收结果、质量是否守住、阶段退出还缺什么、下一步与必要用户配合,再列证据。源码接入、工具可见、手机验证、用户反馈分别取证;承诺了反馈路径却未取结果时明确未完成,不自称主项目效果已交付。

输出必须让后续智能体无需重新猜测即可回答:项目是什么、当前目标是什么、哪些事实可信、哪些内容不能碰、还有什么不知道、进入下一阶段前缺什么。用户点名多个审计领域时,逐项标记“有发现 / 未发现 / 证据不足”,并把证据不足保留为未知项;不能用篇幅或发现数量冒充领域已覆盖。接管报告不宣布代码、真机、云端、上传、验收或发布成功。

## 已批准批次的变体与复验

已批准代表样片后,按明确的清晰度、风格、演示方式和已授权语言/资产范围自主完成其余变体,不逐文件重问;新产品差异才请求决定,不能把样片认可扩大为未展示业务通过。操作演示保留真实入口与完整菜单,核字幕遮挡和承诺语言;模拟简短标明,素材验收不冒充设备/外部业务证据。不要求所有项目制作动画或新建媒体计划。

实际只修fixture入口且冻结产物/配置未变,复用合格部分,仅补原失败及未执行项并保留原FAIL;共享组件、构建开关或上传配置变化则补受影响验证,不能借“只测新增”漏保护。用实际输入/产物指纹和执行轨迹核复用,源码桩不写成工具/手机验证,不让负责人重建已正确工程。
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall