SuperAPI AI 工具集

agentic-dev

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

用途

Agentic Dev 是一个规范驱动(spec-driven)的开发工作流技能,用于在开发新功能或进行变更时,借助 OpenSpec 进行变更跟踪。它同时支持交互式(人在回路)和全自动(Ralph Loop)两种执行模式。

何时使用

根据资料中的决策图,使用时机如下:

  • 如果是新功能或新变更,且属于新能力,则使用 /agentic-dev proposal。
  • 如果是缺陷修复或拼写错误,则直接修复,跳过 OpenSpec。
  • 提案批准后,若有人可参与,使用 /agentic-dev apply(交互式);若无人在场(Ralph Loop),使用 /agentic-dev apply --mode=auto。
  • 实现完成后,使用 /agentic-dev done。

三阶段工作流

阶段 命令 输出
1. 提案 /agentic-dev proposal OpenSpec 提案文件
2. 应用 /agentic-dev apply <id> [--mode] 已实现的代码
3. 完成 /agentic-dev done <id> 已归档并更新规范

阶段 1:提案

通过头脑风暴创建 OpenSpec 变更提案:

  1. 理解上下文 — 检查项目状态
  2. 提问 — 一次一个问题,优先多选
  3. 提出方案 — 2-3 个选项并附权衡
  4. 增量设计 — 以 200-300 字的分段呈现,逐段验证
  5. 创建任务 — 分解为可实施的任务
  6. 生成 OpenSpec 文件 — proposal.md、design.md、tasks.md、spec deltas

方法论: @prompts/brainstorming.md

完成信号: <promise>PROPOSAL COMPLETE</promise>

阶段 2:应用

提供两种模式:

交互模式(默认)

/agentic-dev apply add-shortcuts
  • 每个任务后审查检查点
  • 人类可在任务之间介入
  • 更高质量保证

自动模式(Ralph Loop)

/agentic-dev apply add-shortcuts --mode=auto
  • 每次迭代一个任务
  • 仅自我审查
  • 将 tasks.md 作为状态机更新
  • 无人值守执行

方法论: @prompts/tdd.md、@prompts/review.md

完成信号: <promise>IMPLEMENTATION COMPLETE</promise>

阶段 3:完成

完成并归档变更:

  • 验证 tasks.md 中所有任务已完成
  • 验证测试通过
  • 呈现分支选项(合并/PR/保留/丢弃)
  • 归档到 OpenSpec
  • 验证规范已更新

方法论: @prompts/branch-completion.md

完成信号: <promise>ARCHIVE COMPLETE</promise>

输出结构

openspec/changes/<change-id>/
├── proposal.md      # 元数据
├── design.md        # 架构与方法
├── tasks.md         # 实施任务(状态机)
└── specs/           # 规范增量
    └── <capability>/
        └── spec.md

方法论文件

文件 用途
@prompts/brainstorming.md 协作式设计探索
@prompts/tdd.md 测试驱动开发
@prompts/review.md 自我与代码审查
@prompts/branch-completion.md 分支收尾工作流

Ralph Loop 集成

用于全自动实现:

/ralph-loop "/agentic-dev apply <change-id> --mode=auto" \
  --completion-promise "IMPLEMENTATION COMPLETE" \
  --max-iterations 50

自检机制:每次迭代读取 tasks.md,找到下一个未完成的 - [ ] 项,执行它,更新为 - [x],输出 promise,然后停止。Ralph Loop 会重新调用,直到全部完成。

Promise 标签

事件 Promise
提案完成 <promise>PROPOSAL COMPLETE</promise>
单个任务完成 <promise>TASK N COMPLETE</promise>
全部实现完成 <promise>IMPLEMENTATION COMPLETE</promise>
归档完成 <promise>ARCHIVE COMPLETE</promise>

模式对比

方面 交互式 自动
审查 自我 + 检查点 仅自我
人类 可介入 无人值守
成本 较高 较低
质量 最高 良好(强制 TDD)
适用场景 复杂功能 夜间运行

前提条件

  • 项目中已配置 OpenSpec(openspec/ 目录)
  • ralph-loop 插件(可选,用于自动模式)

快速参考

# 阶段 1:创建提案
/agentic-dev proposal
> 我想添加键盘快捷键支持...

# 阶段 2:实施(交互式 — 有人在场)
/agentic-dev apply add-shortcuts

# 阶段 2:实施(自动 — Ralph Loop)
/ralph-loop "/agentic-dev apply add-shortcuts --mode=auto" --completion-promise "IMPLEMENTATION COMPLETE"

# 阶段 3:归档
/agentic-dev done add-shortcuts

限制

资料中未提供关于定价、收费、平台支持范围、性能效果或具体使用步骤的更多信息,暂未提供。