用途
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 变更提案:
- 理解上下文 — 检查项目状态
- 提问 — 一次一个问题,优先多选
- 提出方案 — 2-3 个选项并附权衡
- 增量设计 — 以 200-300 字的分段呈现,逐段验证
- 创建任务 — 分解为可实施的任务
- 生成 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
限制
资料中未提供关于定价、收费、平台支持范围、性能效果或具体使用步骤的更多信息,暂未提供。