init-milestoneslisted
Install: claude install-skill fitlab-ai/agent-infra
# 初始化 milestones
一次性初始化仓库的标准 milestones 体系。
## 执行流程
### 1. 验证前置条件
确认以下条件成立:
- 执行前先读取 `.agents/rules/label-milestone-setup.md`
- 请求的 milestone 参数已准备完成
如果任一条件失败,停止并输出对应错误。
### 2. 运行 milestones runtime intent
执行以下命令,完成整套里程碑初始化流程:
```bash
agent-infra-internal platform-metadata init-milestones $ARGUMENTS
```
runtime intent 与 `.agents/rules/label-milestone-setup.md` 共同负责:
- 接收 `--history` 请求并规划目标里程碑
- 按既定基线、history、状态和标题幂等契约生成结果
- 由 runtime/provider 读取并写入当前里程碑
- 输出最终执行摘要
### 3. 标准里程碑定义
按固定描述创建以下里程碑:
- `General Backlog`:`All unsorted backlogged tasks may be completed in a future version.`(state=`open`)
- `{major}.{minor}.x`:`Issues that we want to resolve in {major}.{minor} line.`(state=`open`)
- 具体版本:兼容默认来源使用基线 `0.1.0`;合法 tag 来源使用 `{major}.{minor}.{patch+1}`。描述为 `Issues that we want to release in v{version}.`(state=`open`)
当传入 `--history` 时,每个历史 `vX.Y.Z` tag 还会额外贡献:
- `X.Y.x` 作为开启状态的线里程碑
- `X.Y.Z` 作为关闭状态的版本里程碑(`state=closed`)
### 4. 输出与行为保证
摘要必须包含:
- 版本基线
- 版本基线来源
- 是否启用 `--history`
- 创建与跳过的里程碑数量
- 新创建的里程碑标题
- 已存在的里程碑标题
执行说明:
- Milestone titles are treated as the idempotency key.
- General Backlog 是未分类工作的兜底里程碑。
- 不带 `--history` 时,只创建一个标准版本里程碑:兼容默认来源使用基线 `0.1.0`,合法 tag 来源使用下一次 patch 版本。
- 历史 `X.Y.Z` tag 会生成开启状态的 `X.Y.x` 和关闭状态的 `X.Y.Z`。
- 标签较多的仓库可能触发平台 API rate limit。
### 5. 告知用户
> 渲染下一步前先读取 `.agents/rules/next-step-output.md`,仅为已选场景调用统一 helper,并将 stdout 填入 `{next-step-commands}`。
输出 milestones 初始化摘要后,提示:
使用 `agent-infra-internal agent-client next-steps --skill ini