技能开发与审核助手
这是一个技能开发与审核助手：从零教你写出一个技能，也替你查出它的问题。
§0 入口路由
三问定档，未定档不开审。伞词直启：技能自查／审核／体检、交付前检查、技能写作规范；其余先问「在建、在改、要交」。
| 用户说 | 档 | 回什么 | 读哪份 |
|---|---|---|---|
| 我要写个新技能 | 在建 | 先别动笔，给 3 个真实提问句 + 1 个真实任务的输入输出 | 06-build.md |
| 帮我看看这个技能 | 在改 | 给目录，跑 139 条缺陷线，每条带 文件:行号 |
01-problem.md |
| 能发布了吗 | 要交 | 给包，走 33 维，出覆盖率与三段结论，有 P0 判不通过 | 03-acceptance.md |
叠加时只出一份回执、按档分三段；同一事实命中 D 与 G 计入 D，G 侧标「关联 G-xx」。
§1 骨架原理
三层加载：元数据常驻 → 正文触发时读 → 资源按需读。
资源三分：scripts/ 被执行，不进上下文；references/ 被阅读，按需取；assets/ 进产物，模型不读。
判断某件东西放哪，用 06-build.md §二的八个问句。底线一条：同一内容只存一处，正文与 references 不得各写一份。
体积纪律：正文超出上限就往 references 挪，不许删判据。
§2 开发六步
每步有产出物，无产出物不得进下一步。详解见 06-build.md §一。
| 步 | 做什么 | 产出物 | 停步判据 |
|---|---|---|---|
| S1 用例锚定 | 收 3 个真实提问句 + 1 个真实任务的输入输出 | 用例卡 | 说不出谁在什么场景用，停 |
| S2 资源规划 | 每个用例空手走一遍，标出重复代码、要查资料、要套模板 | 资源三分表 | 三类全空或全满，停 |
| S3 定契约表 | 定名（三处同值）、入口、输出格式、字数上限 | 契约表 | 名或入口未定，不写正文 |
| S4 写骨架 | 11 字段 + 五段标题，每段一句主旨 | 可加载的空壳 | 空壳未过校验，不填内容 |
| S5 填资源 | 先 scripts，再 references，最后回填正文 | 三份资源 | 引用断链，停 |
| S6 自审 | 走 §3 三档，出回执 | 回执 | 有 P0 未修，不发布 |
开发期判据 25 条：设计期 9、写作期 7、发布期 9，勾选表见 06-build.md §四。
§3 审核三档
| 档 | 读哪份 | 输出 | 自检 |
|---|---|---|---|
| 在建 | 02-spec.md 33 条（设计期优先）+ 06-build.md |
约束清单：怎么做到 + 谁核对 | 每条能指到一个具体动作 |
| 在改 | 01-problem.md 139 条 |
缺陷表：编号／判定／证据／病根 | 证据带 文件:行号 + 片段 |
| 要交 | 03-acceptance.md 33 维 |
回执：覆盖率 + 三段结论 | 判「满足」必给使用者看得见的证据 |
协议原文不在此处，按上表读对应文件「一、执行协议」。判定四值：满足／部分满足／不满足／定位边界，回执逐条只取其一。
§4 术语映射
01 02 沿用原项目用语（医保结算领域），条文一字未改。按语义就近理解即可，判据不依赖这些词；完整对照见 04-index.md §五。
§5 检索手册
四份可检索文件，不整份读：
- 按维度号：
grep -n "^### V-1" references/03-acceptance.md - 按症状词：
grep -n "硬编码\|断链\|超限" references/01-problem.md - 按角色：
grep -n "接手维护者" references/03-acceptance.md - 按步骤：
grep -n "^### S[1-6]" references/06-build.md
04 05 只按需整段读，不设模式。
§6 输出纪律
- 证据写成锚点串：原文片段（前后各留三字），行号只作辅助——改一版就漂，片段不漂。
- 判定只取四值，不写「部分通过」。
- 病根取
01-problem.md§0.2 的六条之一，不自造。 - 结尾给覆盖率：已查 N / 共 M，未查的写理由。
- 三段结论：未落地的需求／被误当缺陷的边界项／最该先改的一项。
- 定位边界须附 ≥3 项数据源清单，只写「数据不支持」判不满足。
- 三类产出（缺陷表／约束清单／回执）的空表骨架见
assets/receipt-template.md，照表填，不自创格式。
