docs(governance): make SOP skillization explicit in OpenSpec contract

Context:
A follow-up review highlighted that the standalone governance change mentioned automated checkpoints but did not explicitly encode the “SOP skillization” requirement raised in PR #113.

Updates in this commit:
- proposal: adds explicit scope for skillizing governance lifecycle stages (kickoff/execution/completion/verification)
- design: adds a dedicated decision for checkpoint-to-skill mapping and skill-based governance execution semantics
- specs:
  - documentation-lifecycle-traceability: adds requirement that key SOP stages MUST be represented by callable skills
  - design-reconstructability-governance: adds requirement to maintain auditable checkpoint-skill mappings
- tasks: adds a dedicated SOP skillization workstream and renumbers pilot tasks accordingly

Verification:
- openspec validate --changes enhance-doc-governance-traceability
- openspec status --change enhance-doc-governance-traceability --json

Author: mindfn

openspec/changes/enhance-doc-governance-traceability/design.md

@@ -11,6 +11,7 @@ PR #113 已明确把“文档治理哲学互学”拆分为独立变更执行。
 - 定义 frontmatter 最小合约并约束跨文档挂接字段。
 - 建立活跃索引与归档迁移规则，避免上下文散落。
 - 将关键门禁（文档更新、gap/TODO 映射、聚合完整性）转化为可自动检查的 checkpoint。
+- 将文档治理 SOP 关键阶段 skill 化，使治理执行不仅“有规范”，且“可调用、可复用、可审计”。
 
 **Non-Goals:**
 - 不引入新的运行时能力或 agent 执行路径变更。
@@ -38,6 +39,11 @@ PR #113 已明确把“文档治理哲学互学”拆分为独立变更执行。
 - 新变更从生效日起必须满足聚合 + frontmatter + checkpoint。
 - 历史文档按活跃优先级回填，不阻塞本次治理基线落地。
 
+### Decision 5: 关键治理步骤由 Skill 承载执行语义
+- 方案 A（采用）：把 kickoff/completion/verification 等关键步骤映射为仓库内技能（skills），并维护“checkpoint -> skill”映射文档。
+- 方案 B（不采用）：只在 SOP 文档里描述步骤，不提供可调用 skill。
+- 理由：仅文档约束容易漂移；skill 化可以将治理流程变成可执行协议，降低执行歧义并支持自动审计。
+
 ## Risks / Trade-offs
 
 - [Risk] 新增 frontmatter 与聚合文档带来短期编辑负担  
@@ -49,13 +55,17 @@ PR #113 已明确把“文档治理哲学互学”拆分为独立变更执行。
 - [Risk] 历史文档不完整导致初期误报  
   → Mitigation: 校验范围优先限制到“本次变更触达文件 + 新增文件”。
 
+- [Risk] skill 规范与 SOP 文档双处维护导致不一致  
+  → Mitigation: 强制维护 checkpoint-skill 映射源文件，并在 CI 中校验映射完整性。
+
 ## Migration Plan
 
 1. 新增治理聚合模板与 frontmatter 合约文档。
 2. 在 `docs/guides` 与 `docs/design` 回写执行顺序与术语。
-3. 增加 CI 检查脚本（聚合入口、frontmatter、gap/TODO 映射）。
-4. 选取一个活跃变更做样例回填，验证流程可用性。
-5. 将 checkpoint 从 warning 提升为阻断门禁并更新贡献指南。
+3. 增加/更新治理 skills，并建立 checkpoint 到 skill 的映射文档。
+4. 增加 CI 检查脚本（聚合入口、frontmatter、gap/TODO 映射、skill 映射完整性）。
+5. 选取一个活跃变更做样例回填，验证流程可用性。
+6. 将 checkpoint 从 warning 提升为阻断门禁并更新贡献指南。
 
 回滚策略：若新 gate 导致大量误报，可临时降级为 warning，同时保留文档合约与聚合模板，不回退语义规范。
 
@@ -64,3 +74,4 @@ PR #113 已明确把“文档治理哲学互学”拆分为独立变更执行。
 - frontmatter 字段名统一使用 `feature_ids` 还是 `change_ids` 作为主字段？
 - 聚合文档目录命名是否固定为 `docs/features/`，还是放入 `docs/governance/`？
 - 是否在后续迭代增加自动生成聚合骨架（由脚本从 OpenSpec change 初始化）？
+- 治理 skill 放在 `.codex/skills/governance-*` 还是并入现有 openspec skills（保持职责边界）？

openspec/changes/enhance-doc-governance-traceability/proposal.md

@@ -8,6 +8,7 @@ PR #113 中已经确认“文档治理哲学互学”应拆到独立 OpenSpec 
 - 定义并落地文档 `frontmatter` 最小字段合约（如 `feature_ids` / `topics` / `doc_kind` / `created`），用于机器可检索追溯。
 - 增加活跃治理索引与状态迁移规则（active -> archived），避免长期任务上下文分散。
 - 把关键治理门禁转化为可验证 checkpoint（脚本/CI 检查），覆盖：文档更新、gap/TODO 关联、聚合入口完整性。
+- 将文档先行 SOP 的关键阶段（kickoff / execution / completion / verification）显式 skill 化，并维护 checkpoint 与 skill 的映射关系。
 - 在现有 `docs/guides/*` 与 `docs/design/*` 中回写统一术语与执行顺序，确保与 OpenSpec 工作流一致。
 
 ## Capabilities
@@ -28,5 +29,8 @@ PR #113 中已经确认“文档治理哲学互学”应拆到独立 OpenSpec 
 - Affected automation/checks:
   - `scripts/ci/check_design_doc_drift.sh`（或新增 companion check）
   - CI gate 组合中的文档治理校验步骤
+- Affected skills/docs:
+  - `.codex/skills/*`（新增或更新治理相关 skills）
+  - skill 与 checkpoint 的映射文档（路径将在 design/tasks 中定版）
 - API/runtime impact:
   - 无运行时接口变更（non-breaking）

openspec/changes/enhance-doc-governance-traceability/specs/design-reconstructability-governance/spec.md

@@ -28,3 +28,11 @@
 - **WHEN** 提交包含治理相关实现或文档变更但未补齐 gap/TODO 映射
 - **THEN** 自动化检查报告失败
 - **AND** 报告指出缺失项与期望文件路径
+
+### Requirement: 可重建性治理必须维护 checkpoint-skill 映射
+可重建性治理 MUST 维护一份 checkpoint 到 skill 的映射清单，确保 SOP 的关键阶段具备可执行承载并可被审计。
+
+#### Scenario: 评审者可验证 SOP skill 化覆盖
+- **WHEN** 评审者检查治理流程资产
+- **THEN** 能定位到关键 checkpoint 对应的 skill 名称与路径
+- **AND** 能确认该映射与 CI 检查项一致

openspec/changes/enhance-doc-governance-traceability/specs/documentation-lifecycle-traceability/spec.md

@@ -31,3 +31,11 @@
 - **WHEN** 变更触达治理范围文件但缺失聚合入口或 frontmatter 关键字段
 - **THEN** CI 校验失败并输出可操作修复提示
 - **AND** PR 在补齐治理资产前不得通过完整 gate
+
+### Requirement: 治理 SOP 关键阶段必须 skill 化
+治理流程中的关键阶段（至少包含 kickoff、completion、verification）MUST 对应到可调用 skill，并维护 checkpoint 到 skill 的稳定映射关系。
+
+#### Scenario: 治理任务可由 skill 驱动执行
+- **WHEN** 维护者或 agent 执行治理类变更
+- **THEN** 可定位到对应阶段的 skill 入口与使用说明
+- **AND** 能从映射关系中确认该阶段对应的 gate/checkpoint

openspec/changes/enhance-doc-governance-traceability/tasks.md

@@ -16,8 +16,14 @@
 - [ ] 3.2 Implement or extend CI checks to validate required frontmatter fields for governance-tracked docs.
 - [ ] 3.3 Implement or extend CI checks to validate gap/TODO -> OpenSpec task mapping completeness.
 
-## 4. Pilot backfill and closure evidence
+## 4. SOP skillization implementation
 
-- [ ] 4.1 Backfill one active governance change using the new aggregation + frontmatter contract as pilot evidence.
-- [ ] 4.2 Run governance check scripts and capture passing command output in PR evidence.
-- [ ] 4.3 Update TODO/archive records and mark this OpenSpec change as complete with evidence links.
+- [ ] 4.1 Define and publish a checkpoint-to-skill mapping document for governance lifecycle stages.
+- [ ] 4.2 Add or update governance skills for kickoff/completion/verification stages under repository-managed skills.
+- [ ] 4.3 Add CI validation to ensure required governance checkpoint-skill mappings are present and non-stale.
+
+## 5. Pilot backfill and closure evidence
+
+- [ ] 5.1 Backfill one active governance change using the new aggregation + frontmatter + skill mapping contract as pilot evidence.
+- [ ] 5.2 Run governance check scripts and capture passing command output in PR evidence.
+- [ ] 5.3 Update TODO/archive records and mark this OpenSpec change as complete with evidence links.