NocodeMrLi/mini-program-engineering-skill-suite / skills/mini-program-project-intake-skill
mini-program-project-intake-skill
VerifiedPerform 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
| agents/openai.yaml | config | 288 B |
| assets/project-fact-map.md | markdown | 1.5 KB |
| references/intake-workflow.md | markdown | 9.5 KB |
| references/relocation-and-pivot-audit.md | markdown | 2.1 KB |
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;共享组件、构建开关或上传配置变化则补受影响验证,不能借“只测新增”漏保护。用实际输入/产物指纹和执行轨迹核复用,源码桩不写成工具/手机验证,不让负责人重建已正确工程。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 468k | Updated | Claude CodeCodex | Verified | Install |
| 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: 468k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |