init-milestoneslisted
Install: claude install-skill fitlab-ai/agent-infra
# 初始化 milestones
一次性初始化仓库的标准 milestones 体系。
## 执行流程
### 1. 验证前置条件
确认以下条件成立:
- 执行前先读取 `.agents/rules/label-milestone-setup.md`
- 按其中的认证命令验证平台访问能力
如果任一条件失败,停止并输出对应错误。
### 2. 运行初始化脚本
执行以下命令,完成���套里程碑初始化流程:
```bash
bash .agents/skills/init-milestones/scripts/init-milestones.sh "$ARGUMENTS"
```
脚本与 `.agents/rules/label-milestone-setup.md` 共同负责:
- 创建并清理临时工作目录
- 检测是否传入 `--history`
- 扫描所有 `v*` Git tag,按 SemVer precedence 选择最高合法版本;没有合法版本时使用兼容默认值 `0.1.0`,且不读取任何生态 manifest
- 使用平台对应的 milestones 查询命令读取当前里程碑
- 构建目标里程碑集合,并且只创建缺失标题
- 输出最���执行摘要
### 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 初始化摘要后