用途:在需要创建或更新业务功能文档时使用,按统一模板生成 17 个章节的功能文档,并支持对已有文档做陈旧度审计。
主要能力:三种模式——init(无 docs/business-features/{Module}/ 时从零生成完整 17 章节文档)、update(文档已存在且代码变更时按章节影响映射更新)、audit(显式 --audit 或用户要求时输出逐章节陈旧度报告)。工作流为:检测与收集、调查代码、撰写文档、四轮验证(证据审计、领域模型、交叉引用、AI 可实现性)。
使用方式:在 Codex 中用 $skill-name 调用仓库技能;执行前先建立任务跟踪并保持同步。文档输出到 docs/business-features/{Module}/,模板为 docs/templates/detailed-feature-docs-template.md,需先读 docs/project-reference/spec-principles.md 与 feature-docs-reference.md。
关键规则:每个测试用例必须有可验证代码证据,格式为 [Source: {namespace}/{service}/{id}] 抽象锚点,物理 file:line 只放在 provenance sidecar;正文保持技术无关,不得出现框架、语言、类名、文件路径;每个 FR/BR/OP/TC 都要有逻辑 ID;修改文档时须更新 CHANGELOG.md 与第 17 节版本历史;集成测试需带 [Trait("TestSpec", "TC-{FEATURE}-{NNN}")],缺失则标记 Untested;第三轮验证发现超过 5 个问题须停止并重跑验证。
适用场景:需要为业务模块生成或维护结构化功能文档、并希望文档可被 AI 直接实现或重建的团队。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;部分步骤依赖项目自身的目录结构与文档约定,若环境无法运行所需步骤应停止并询问用户。