SuperAPI AI 工具集

build-workflow-execute

办公与效率

查看项目

更新于 10-16 09:45

技能介绍

用途:在 plan 已批准后开始实现,按计划逐任务增量生成软件代码或内容产物。入口为已批准计划(docs/features/<name>/03-plan.md 及可选 plans/*.md),出口为产物、验证证据和 ADR,完成后指向 verify-workflow-review,遇 Bug 转向 verify-workflow-debug。

主要能力:读取计划拓扑,调用 build-cognitive-execution-engine 选择 inline、subagent 或 parallel 执行模式;执行 Task-by-task 循环,每个 ### Task N 为最小执行单元,验证未通过不进入下一任务;支持 serial、gated-parallel、parallel 三种拓扑,仅当 Parallel Execution Matrix 证明 parallel_safe 时才允许并行,否则降级串行并记录原因;按 artifact_type 加载领域技能(software 走 TDD,document/article、deck、visual 各有对应流程);遇架构决策调用 build-cognitive-decision-record 产出 ADR。

使用方式:先读 03-plan.md 总控计划,再按编号读取子计划,确认 Plan Topology、Write Scope、Shared Contracts 等字段;每任务执行 实现→测试→验证→提交,用描述性信息提交,一个提交一个逻辑变更;不完整功能用 feature flag 隔离。并行分派仅限 parallel_safe 任务,subagent 的 changed_files 不得越出 Write Scope;不满足证据条件则 STOP 回 /plan。

适用场景:已有获批计划的软件开发、文档、文章、演示、视觉产物实现;不适用于探索性原型(可跳过 TDD 但受 HARD GATE 约束)与纯配置变更。

限制:本技能不重新创建任务列表,发现 PLAN GAP 须回 /plan 修补;技术障碍、检查点未通过、shared contract 失败、release/export/ship 标记 parallel_safe 等均须停止或收口串行。验证证据需包含输入来源、执行动作、验证结果与阻塞回退。具体命令示例、依赖版本与接口细节资料未提供。