codify-to-knowhow

> **Plan tracking**: codex 无 TaskCreate/TaskUpdate/TodoWrite 任务板。进度清单用 `update_plan({ explanation?, plan: [{ step, status }] })` 维护（整体提交步骤数组，status: `pending` | `in_progress` | `completed`），权威状态始终在 session 工件中；依赖/认领（addBlockedBy/owner）是工件字段，不是工具参数。 # Codify to Knowhow 通用 manifest 驱动的知识资产生成器。读取 `knowhow-manifest.json`，按声明创建 knowhow 文件和 spec 条目，通过 ref 建立索引-详文桥梁。 **适用场景**: 任何工作流产出需要固化为知识资产时使用。上游 skill（如 `maestro-impeccable --codify`）负责生成 manifest，本 skill 负责执行知识写入。 ## Architecture Overview ``` ┌─────────────────────────────────────────────────────────────┐ │ Codify to Knowhow (SKILL.md) — Manifest-Driven │ │ → Read manifest → Create knowhow → Create specs → Verify │ └──────────────────────────┬──────────────────────────────────┘ │ ┌──────────┬───────────┼───────────┬──────────┐ ↓ ↓ ↓ ↓ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │Phase 1 │ │Phase 2 │ │Phase 3 │ │Phase 4 │ │ │ Load │ │Generate│ │Generate│ │ Index │ │ │Manifest│ │Knowhow │ │ Specs │ │ Verify │ │ └───┬────┘ └───┬────┘ └───┬────┘ └───┬────┘ │ │ │ │ │ │ manifest AST-/DCS- spec-entry verified │ parsed files + ref assets │ ``` ## Key Design Principles 1. **Manifest 驱动**: 所有行为由 `knowhow-manifest.json` 声明，不含硬编码领域知识 2. **幂等执行**: 每个写入前按 slug 检查已存在资产，存在则跳过 3. **ref 桥梁**: spec-entry 通过 `ref` 引用 knowhow 详文 4. **闭合标签**: 所有条目使用...