SuperAPI AI 工具集

doc-flow

通用与其它

查看项目

更新于 10-16 01:28

技能介绍

doc-flow 是规范驱动开发(SDD)流程的路由与编排技能,属于跨层工具,没有上游产物,可路由进入全部 8 层。它自身不创建任何产物,产物由各层的 artifact 技能生成。

八层流程为:BRD(1)→ PRD(2)→ EARS(3)→ BDD(4)→ ADR(5)→ SPEC(6)→ TDD(7)→ IPLAN(8)→ Code。各层对应基础技能分别为 doc-brd、doc-prd、doc-ears、doc-bdd、doc-adr、doc-spec、doc-tdd、doc-iplan。每层提供四个技能:base(创建)、-autopilot(端到端)、-audit(闸门报告)、-fixer(应用审计修复)。

主要用途:当不确定应使用哪个技能时使用 doc-flow;按动词选择技能——create/draft 对应某层 base 或 -autopilot,audit/score 对应 -audit,fix/remediate 对应 -fixer,validate/trace/links/orphans 对应 ../doc-validator/SKILL.md,修改已发布产物对应 ../doc-chg/SKILL.md 加 ../gate-check/SKILL.md。当用户点名某技能时直接运行该技能。

流程定位:扫描 docs/<NN><X>/ 下的产物,读取各产物的 Document Control Status(多数层为 Draft → In Review → Approved;IPLAN 为 Draft → In Progress → Completed),映射到项目激活层,报告位置与进度(终态产物数 ÷ 激活层数)。必做模板一致性检查:加载 ${CLAUDE_PLUGIN_ROOT}/framework/layers/<NN><X>/<TYPE>-TEMPLATE.yaml,核对每个必需顶层章节是否以 ## 标题出现,缺失即报告为漂移。

下一步建议按累积链给出,优先级 P0(必需上游缺失或关键路径下一步)、P1(P0 解除后下一个就绪层)、P2(可选/并行工作),并指出并行工作机会。

上游产物策略:不要虚构缺失的上游产物;上游存在则以其精确 ID 引用,必需上游缺失则跳过并建议先创建,可选上游缺失则在 tag 中置 null,不适用则省略该 tag。

变更管理:已发布产物的变更走 CHG 覆盖流程而非线性流程,由 ../doc-chg/SKILL.md 分类(C1–C3 / Emergency)并路由到相应闸门,../gate-check/SKILL.md 运行闸门并准备签核表单;最终由人工批准,技能不会自行批准。

适配:读取 .aidoc/profile.yaml,尊重 active_layers;被禁用的可跳过层(BDD / ADR)会从关键路径、进度分母与下一步建议中排除。无 profile 时使用完整 8 层流程。

读取内置文件时使用 ${CLAUDE_PLUGIN_ROOT}/framework/… 路径,该变量由 Claude Code 在安装时设置,未设置时 framework/ 位于插件根的 skills/ 旁。其他资料未提供更多使用步骤与限制细节。