[Eridanus117]

做了什么

票 agent-system#116（spec agent-system#115 的第一批，源自 desk#152）：自建 skill 的写法合同与词汇表换成「业界词、两节骨架、正面句」。

• plugins/CONTEXT.md：每个词条标题带英文原词与出处，形状 **中文**（English；出处：…）:；spec 替换表 15 行全部落地（查询、标准变更、常规变更、阶段、门、活动、站会记录、违例／判断题、上线清单、在制品、主题、路由 skill、人敲的／模型可拿的；「来往」「可选步」两行按 spec 不起名，用平语说明）；旧词以 _旧名_ 一行保留到收口票 票9 收口：归档 workcoding、删旧词别名、更新工作方法地图 #123；Avoid 里的 user-invoked／model-invoked 转正为词条名；新增实践、规程、真源三条。
• skill-authoring 的 writing-rules.md：骨架只必有「什么时候用」「步骤」两节、每步带完成判据，产出／出口／为什么在哪按需，删「路由边界」「自检」「验证状态」三类节；术语只用有出处的业界词；每条禁令紧跟一句正面目标；加「实践与规程分两层」一节。
• eval-cases.md：加「grader 判可观测行为，不判消息形状；形状模板放 references，正文只引用」。
• plugins/tests/skills.test.ts：两条守卫——所有 SKILL.md 与 plugins/CONTEXT.md 不含「自造」标记（，自造） 与 「自造」 两种写法，正文里「自造词」这类普通用法不拦）；词汇表每个词条带英文原词与出处（先剥 fenced code block 再数）。
• docs/adr/0006、0007：按 spec：自建 skill 写法合同——业界词、实践与规程分层、正面陈述（镜像 desk#152） #115 评论里的草稿落成文件，状态 accepted，README 目录加两行。0006 相对草稿有一处按票改：Avoid 里的 user-invoked／model-invoked 不是删掉而是转正。
• skill-authoring SKILL.md 第 6 步改成两节骨架；版本 0.1.0 → 0.1.1（marketplace 同步），目录页重生成；definition-of-done.md、vendor-adoption.md 里的「剪枝四查」改成平语。

不在本 PR：flow 与 flow-steps 换词（#117）、agent-config 共用规则（agent-config#57）、practices（#118 起）。skill-authoring 自身正文的旧名留给收口票 #123（已写进 ADR-0006 接入顺序第 5 步）。第 3 段拆票在 desk#152 已做，第 8 段发布跳过：改的是仓内文档与测试，合并即生效。

为什么

• 票：agent-system#116；spec：agent-system#115（替换表、盲测备注）；机会 issue 与方案对齐记录：desk#152。
• 决定：ADR-0006（术语只用有出处的业界词，实践与规程分两层）、ADR-0007（Matt 的四条实践复制入库）。

怎么验证的

均在 HEAD c8b4b23 上刚跑过：

$ node plugins/tests/skills.test.ts
PASS: 12 个 Plugin、23 个 Skill，目录页一致，词汇表 26 条带英文与出处
exit=0

$ node plugins/tests/skill-evaluation.test.ts            # exit=0
$ node plugins/orchestrated-collaboration/tests/verify-three-party-review.test.ts
PASS: CF-6 三方审阅验证器合同                             # exit=0

$ claude plugin validate plugins/skill-authoring
✔ Validation passed                                        # exit=0

$ bun packages/mounts/src/cli.ts assess-public-tree --repo . --rev HEAD --policy .github/public-tree-policy.json
status: allowed (scanned 1477)                             # exit=0

守卫的红：改测试后、改词汇表前跑一次，AssertionError: plugins/CONTEXT.md: 出现「自造」标记（，自造））；把一条词条改成缺英文、缺出处两种坏形状各跑一次，分别报「词条缺英文原词」「词条缺出处」。

改前改后评测（skill-authoring，claude plugin eval plugins/skill-authoring -j 4 --allow-tools Write --judge-model sonnet --max-cost-usd 20 --no-publish --trust-plugin，每用例 3 次带对照组）：

用例	改前 2026-09-15 差值	改后 2026-09-19 差值
thin-step-skill	1.0	1.0
gate-skill	0.22	0.33
routing-skill-stops	1.0	1.0
retire-out-of-scope	1.0	1.0
feedback-modify	1.0	1.0

改后 5 用例全过，平均差值 +0.87，608 秒，约 8.0 美元；结果在 evals/results/2026-09-19-gate/aggregate-result.json，用户名已用 scrub-eval-results.ts 换成 <user>。

code-review 两轴（规范、spec）共 8 条违例，负责人判「全修」后已修（commit f477e39）：写法规则不再用词汇表外的词、五条出处换成可引用的、守卫剥代码块并容许嵌套括号、ADR 问题改问句。

怎么回退

revert 本 PR 的合并 commit：词汇表与写法规则回到自造词版本，两条 ADR 文件与两条守卫随之撤掉，skill-authoring 回 0.1.0。评测结果目录与 desk#152 上的停靠记录不需要回退。后续批次（#57、#117、#118）各自独立 revert。

🤖 Generated with Claude Code