change-dispatch

Change Auto-Dispatch

Overview

自动扫描并领取就绪的 OpenSpec 任务组。Runner 无关表示协议不绑定某一种 agent；执行环境仍必须具备项目声明的 Node/pnpm/技术栈工具链、agent CLI、模型凭据、GitHub 写权限和网络访问。

三层解耦：

1. Runner 层（谁触发 dispatch 运行）：cron / /loop Nm /change-dispatch / Codex Automation / GitHub Actions / 人工一次性触发，任选其一
2. Dispatch 逻辑层（本 skill）：扫描 → 认领 → 实现 → push，不关心是谁在跑
3. Executor 层（每个任务组用什么执行模式）：tasks.md 任务组注释的 执行模式: tag 决定；dispatch 兼容旧 执行工具: tag

Branch-Centric 模型： 四件套和实现代码都在 feature branch 上。dispatch 通过 main 上的 backlog 索引找到活跃 change，fetch 对应 feature branch 读取 tasks.md，实现后直接 push。

Announce at start: "Running change-dispatch: scanning for ready task groups."

Bash 命令规范

为兼容 Claude Code / Codex 等不同执行环境的权限与审批模型，所有 Bash 操作必须遵循：

1. 每条命令独立调用 — 不在一条 Bash 中用 &&、||、; 串联多条命令
2. 管道可以用 — 单条命令内的管道（如 git branch -r | grep feat/）是允许的
3. 并行无依赖时分开调用 — 多条独立命令应作为多个并行 Bash tool call 发送

示例：

# ❌ 错误：复合命令触发确认
git fetch origin && git branch -r | grep feat/ && gh pr list --state open

# ✅ 正确：拆分为独立调用
# Call 1: git fetch origin
# Call 2: git branch -r | grep feat/
# Call 3: gh pr list --state open --json number,headRefName,title,isDraft

类型 → 分支/提交前缀映射规则

type 的事实源是 product/backlog.md 的类型列（dispatch Step 1 扫描 backlog 时同一行直接读到，无需从 change-id 字符串反解析）。由 type 映射 branch / commit 前缀：

type	branch 前缀	commit type
feature	feat/	feat
bug	fix/	fix
chore	chore/	chore
hotfix	hotfix/	fix

<branch-prefix> 和 <commit-type> 全流程复用，禁止硬编码 feat/。4 种类型走相同的 dispatch 路径，无例外。

change-id 的命名前缀（fix- / chore- / hotfix-）由 prd-writer 按 type 生成、change-propose 校验，仅作语义标签；dispatch / review 不解析它。

Runner 配置（任选其一）

dispatch 对 runner 的要求包括：git、shell、项目技术栈工具链、依赖安装能力、可调用本 skill 的 agent CLI、模型凭据、GitHub 写权限和网络。触发频率由项目自行配置，需保证不会长期占用分支或压垮 CI。

方式 A — Claude Code /loop（推荐开发期）

/loop <interval> /change-dispatch

优点：零配置；启动/停止方便；可与 change-propose / change-review 的人工或定时触发协作。