Rune

基于 SDD（Spec-Driven Development）的命令行工具，通过向 AI 开发工具注入 command 和 skill，驱动结构化编码流程。

安装

bunx rune init opencode

使用

初始化

bunx rune init opencode

会在项目中创建：

• .rune/ 目录（配置、变更文档、归档）
• .opencode/commands/ 和 .opencode/skills/（注入的 AI 工具配置）

SDD 流程

1. /rune-discuss — 自由讨论需求
2. /rune-plan <变更名> <文档名> — 生成指定规划文档（如 design、task），支持文档间依赖
3. /rune-build <变更名> — 按任务顺序编码实现
4. /rune-archive <变更名> — 归档并清理

状态查看

rune status              # 查看所有变更
rune status <变更名>     # 查看指定变更的详细状态（文档完成情况、依赖状态、下一步建议）

帮助与版本

rune help              # 显示全局帮助
rune help <command>    # 显示指定命令的详细帮助
rune version           # 显示版本号

自定义配置

编辑 .rune/config.yaml 自定义提示词和文档模板。配置文件默认为空，使用内置默认策略；仅覆盖需要自定义的阶段，未配置的阶段使用内置默认配置。

规划阶段的文档支持 depend 字段声明前置依赖，如 task 依赖 design：

stages:
  plan:
    documents:
      - name: design
        prompt: 生成设计文档
      - name: task
        prompt: 生成任务清单
        depend: [design]

开发

bun test          # 运行测试
bun src/cli.ts    # 运行 CLI