docs(skill): transplant prep for #244 audit additions into v0.3/v0.4/v0.5

Preparation only: no v0.3/v0.4/v0.5 text is changed, nothing is
claimed transplanted or deployed. Stacked on feat-audit-pushback
(#244, 39966bd).

- Appendix provenance 00..09: templates/roles/00-08 sources
  (byte-identical to #217) plus 09-auditor extracted from #244's
  appendix; check_appendix.py extended 00..08 -> 00..09.
  SKILL.md sole change (1 line, format-only): 09 chapter heading
  normalised to the strict source form, otherwise the #217
  checker cannot recognise the chapter. check_appendix.py passes
  on the real pack: 10 chapters match; --emit outputs 10 chapters.
- TRANSPLANT-PREP-244.md: per-paragraph transplant diffs for
  #244's +459 lines into v0.3/v0.4/v0.5 with anchors, grades
  (merge / merge+note / partial stop / full stop), chapter-number
  mapping (v0.5: 11-auditor, colliding 09-ops noted), the
  templates/artifacts delete-references decision with 6 sites and
  replacements, and the draft-sync checklist (sync itself is
  post-deployment only, not done here).
- tools/check_transplant.py: anchors / draft-apply /
  check-transplanted modes; draft-apply on the real v0.3/v0.4/v0.5
  texts passes check-transplanted (drafts in /tmp only, not
  committed). Stopped paragraphs are listed, never silently
  rewritten: v0.3 G7/full-auto sentences, v0.4 G7 sentences and
  the tighten-3 pre-rebuild confirmation, v0.5 whole QA section
  plus its checklist item and the confirmation paragraph.
- Tests: test_skill_appendix_provenance.py (00..09) and
  test_skill_transplant_prep.py; 13 new tests pass.
  Suites on this tree: cloud 1523 OK (skipped=4), top-level 105
  OK, deploy 39 OK.
This commit is contained in:
host committed 2026-11-03 02:49:26 +00:00
1 parent 24517d922b
commit dc5df30a07
4 files changed
+1222

No files matched your search

@@ -83,3 +83,40 @@ v0.1 → v0.2 的 5 个 P0 缺口明细无法从本文件追溯,本文件不
`templates/roles/11-auditor.md`(正文与 #258 的 09-auditor 同源);
校验表同步扩为 12 章。§4 的 templates/artifacts 删引用决策
未在集成基底执行(仍待用户拍板),SKILL.md 内 6 处引用原样保留。
## 集成注(code-to10-integration,#258 段)
以下两节原样引自 #258 提交的 CHANGELOG 条目,记录该提交本身的工作;
其中“09-auditor”源文件在本基底的章节表里编号为 11-auditor(v0.5 表
00–08 + 09-ops + 10-iteration + 11-auditor),内容与 11-auditor 源文件
逐字节一致,故 #258 的 09-auditor.md 未重复落盘;#244 向 v0.5 的实际
移植已在本基底的 #244 段完成,与该提交“未移植”的自述不冲突。
## 2026-10-31:#244 向 v0.3 / v0.4 / v0.5 的移植准备(未移植)
- 新增 `TRANSPLANT-PREP-244.md`:#244 新增段落(+459 行)
向 v0.3、v0.4、v0.5 三份文本的逐段移植 diff 准备、
锚点行号、合并 / 移植注 / 停下三档分级、章节号对应表、
templates/artifacts 二选一决策、草稿同步清单。
本轨不改 v0.3 / v0.4 / v0.5 文本,不声称已移植。
- 新增 `tools/check_transplant.py`:移植检查脚本
(锚点检查、草稿移植、移植后检查三模式,见该文件说明)。
- templates/artifacts 决策(本轨定为删引用,见准备文档):
SKILL.md 正文 6 处 `templates/artifacts/` 引用在移植时删除
或改写为正文内联结构,不补模板文件进包、不改播种规则。
本轨不改 SKILL.md 正文,故 6 处引用在本轨包内仍在,
移植检查脚本的移植后检查会把残留引用报为未完成。
## 已知边界(未改行为,另起设计时再动)
- 租户已删 `SKILL.md` 会在下次播种时重建(missing 即复制),
这是现有播种语义,不是删除保留;要保留删除需 tombstone
设计,须另起一轨,不在本条目悄悄改播种行为。
- 校验的允许差异只有三项:章节标题行本身、至多一枚章节间
分隔符行、标题与章末的空行。现行 SKILL.md 的分隔符并不
统一(01/02/03/05/06/08 章后有 `---`,00/04/07 章后无分隔符
直接接下一章标题),校验保留该现状、不强行统一 SKILL.md。
- #244 文本里的“第 1 轨硬门禁”“第 4 轨账本”指审计加固
轨内部的轨号,不是本批“各项指标 9 分以上”的第 1–4 项;
本批第 2 项 attempts-hook、第 3 项 shell 白名单与之无关,
不得混淆(见准备文档)。