SuperAPI AI 工具集

blueprint

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:把 <spec_dir>/requirements.md 转换为 /execute 可直接执行的蓝图,避免返工。核心是契约优先:先锁定模块间如何通信,再让并行任务各自实现。

主要能力:

  1. 契约综合:派生跨模块约定(类型、接口、不变量),写入 contracts.md,并汇总到 plan.json 的 contracts 字段。
  2. 任务图:生成分层 DAG(L0 基础、L1 功能、L2 集成、L3 部署),每个子需求至少被一个任务 fulfills,并标注 depends_on 与 parallel_safe。
  3. 旅程检测:把 ≥2 个子需求组合成端到端用户流程;非 greenfield 时还会从代码爆炸半径生成 [regression] 回归旅程。
  4. 验证计划:为每个子需求和旅程分配验证门(1 机器、2 agent_semantic、3 agent_e2e、4 人工)。
  5. 提交:运行交叉引用校验后交给 /execute。

使用方式:输入为 <spec_dir>/requirements.md(由 /specify 生成),可选已有 plan.json 作为增量补丁。所有 plan.json 操作必须通过 hoyeon-cli,例如:hoyeon-cli plan init <spec_dir> --type <t>、hoyeon-cli plan merge <spec_dir> --json '<payload>' [--patch|--append]、hoyeon-cli plan get <spec_dir> --path <dotted>、hoyeon-cli plan validate <spec_dir>。cli 不解析 requirements.md,读取 markdown 由 agent 用 Read 工具完成。输出仅三个文件:requirements.md(不变)、plan.json(新增/更新)、contracts.md(新增,内容驱动,无跨模块内容时可省略)。

适用场景:greenfield、feature、refactor、bugfix 四类;meta.type 通常来自 /specify 的 frontmatter,缺失时按关键词、仓库状态、子需求数量推断,信号冲突时须询问用户。

限制:不写源代码、不跑测试、不补需求;需求不完整应先运行 /specify。Codex 环境用 Bash 优先的状态操作,v1 不使用 MCP,不依赖 hooks 做会话守卫。契约文件是否生成由内容决定,而非 meta.type。具体收费、平台支持与效果资料暂未提供。