用途:作为规范驱动文档生成与维护的统一入口,让工程规格(docs/specs/{app-bucket}/{system-name}/)与业务功能文档(docs/business-features/{Module}/)两层输出保持同步。
主要能力:提供三种模式。init-full 用于从零开始,步骤为 scout → size-evaluation → plan → plan-review → plan-validate → spec-discovery(init) → feature-docs(init) → review-artifact → docs-update → watzup → workflow-end。update 用于代码变更、新需求或新 PBI,先经 workflow-review-changes 生成影响图,再按需执行 spec-discovery、feature-docs、tdd-spec 等更新步骤。audit 用于定期健康检查与文档新鲜度核验。工程规格为技术无关包(ERD、规则、API、事件、旅程),业务文档为 17 节干系人文档。
使用方式:在 Codex 中用 $skill-name 调用仓库技能。执行前必须先通过直接提问确认模式(Step 0 不可跳过),并建立任务跟踪,逐步更新状态与证据。4 个以上模块需在一条消息中并行派生子代理。若共享技能、工作流、钩子或同步工具变更,需在 $workflow-end 前运行 npm run codex:sync 或记录 N/A 证据。
限制:资料未提供收费、价格、平台支持范围与效果数据。部分步骤依赖 Task 工具、子代理与 git diff 环境;若所需步骤或工具无法运行,应先停止并询问用户。文档路由需显式读取 docs/project-config.json、docs/project-reference/docs-index-reference.md 与 lessons.md,不应盲目读取全部文档。