SuperAPI AI 工具集

workflow-code-to-spec

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

用途:workflow-code-to-spec 是一个从既有代码生成或核对规范文档的工作流。它把每个能力对应的唯一权威规范与实现、测试证据对齐,提供三种模式:init-full(目标范围尚无规范时首次编写)、update(代码变更、新需求或任务后核对更新,默认)、audit(发布前或周期性检查规范是否过时)。

主要能力:确认模式与能力负责人,划定范围并解析所选清单(指纹与发生 ID);调查或审查变更;编写、更新或审计规范;核对与审查用例及变更的规范意图;同步声明的辅助产物;刷新内嵌规范的派生文档;执行结果门禁并收尾交接。它要求代码拥有技术事实、规范拥有效求与行为,只创建声明的派生辅助产物,不建立平行的人工编写树。未知覆盖状态保持 BLOCKED/UNKNOWN。

使用方式:资料给出各模式的步骤序列。init-full 为 investigate → plan(可选,条件性)→ plan --mode=validate(可选)→ spec [mode=init] → spec [mode=tests](可选)→ work-item --mode=review --type=spec-tests --fix-loop(门禁)→ docs-manager --mode=update(可选)→ workflow-end(门禁)→ watzup(可选)。update 为 workflow-review-changes --review-only(门禁)→ spec [mode=update] → spec [mode=tests](可选)→ work-item --mode=review --type=spec-tests --fix-loop(门禁)→ spec [mode=sync](可选)→ docs-manager --mode=update(可选)→ workflow-end(门禁)→ watzup(可选)。audit 为 investigate → spec [mode=audit] → why-review --validate-findings(门禁)→ workflow-end(门禁)→ watzup(可选)。各可选步骤有明确运行条件与跳过原因,需按登记表执行。工作流调用通过 start-workflow 解析模式、前置动作与指纹;在每个步骤或子技能调用前更新待办跟踪,完成或跳过的步骤须附简要证据或明确跳过原因。

质量门禁:编写前解析产物配置(docs/project-config.json 等)、模板与本地规范原则;每个能力追踪完整纵向链路(UI 视图/操作 → API → 处理器 → 领域规则 → 事件 → 消费方/读模型 → UI 结果),断链作为规范发现而非静默丢弃;三方同步要求原生意图/契约/验收角色、配置的用例/证据与执行测试代码一致;规范审查收敛要求用例与规范意图经 work-item 审查,未验证项须有排除理由;update 模式的变更审查须在主会话内联运行且不修改源码,代码缺陷不写入规范;多桶覆盖时台账每行须 REVIEWED 或记录延期原因。

适用场景:为某能力或桶首次编写规范、重大代码变更后、入职/合规交接、迁移前、周期性健康审计。不适用情形:尚无代码时应改用 workflow-planned-work;仅小改一处规范用 spec 或 workflow-feature-spec;交付运行内的变更后同步用 workflow-spec-sync;仅需派生索引或 ERD 用 spec [mode=index]。

限制:本资料未提供收费、价格、支持平台、效果数据等信息。该技能依赖宿主具备技能调用、子代理、待办工具等能力;缺失必需能力时须以步骤/证据和用户提问停止。覆盖范围无法映射时保持 BLOCKED/UNKNOWN。