doc: update Agents.md

2026-06-20 20:08:31 +08:00
parent faa11d909f
commit 0f53f5aa2f
1 changed files with 36 additions and 1 deletions
@@ -1,2 +1,37 @@
 1 严格参考fpa skill
-2 当前这个项目，生成的所有md文件，除了专业术语，请使用中文回复
+2 当前这个项目，生成的所有md文件，除了专业术语，请使用中文回复
+3 发布流程规范
+3.1 发布前必须先做一致性检查，至少包括：
+- `README.md` 是否已更新，且项目简介、产物范围、版本说明与当前仓库状态一致
+- `CHANGELOG.md` 是否已更新，且本次版本新增内容、验证结果、日期和版本号完整
+- `analysis/` 下各轮产物数量是否对齐，特别是 `Persona`、`Story Map`、`Page`、`Feature`、`GWT`、`Feature Spec`
+- `fpa` workflow 状态是否全部符合预期；如果目标是完成 round 6，则相关 `feature_spec` 必须全部是 `approved`
+- `git status` 必须清洁，不能带未计划发布的临时文件、缓存文件或本地系统文件
+
+3.2 发布提交规范：
+- 发布分析产物或发布文档时，提交信息优先使用 `artifact:` 前缀，不使用 `chore:`
+- 如果本次发布除了分析产物，还补充了发布说明文档，应该单独形成清晰提交，避免把分析产物提交和发布文档提交混在无法追踪的杂糅提交里
+
+3.3 Tag 规范：
+- 发布版本前，必须确认 tag 指向的是最终发布提交，而不是中间提交
+- 优先使用 annotated tag，不使用无说明的轻量 tag
+- 版本号采用 `v0.0.1` 这种格式，后续保持一致
+
+3.4 推送规范：
+- 推送前先确认本地分支、提交、tag 都已正确生成
+- 推送时同时推送分支和对应 tag
+- 如果远端尚无该分支，推送后要确认远端分支与 tag 都创建成功
+
+3.5 发布后核对：
+- 核对远端仓库是否存在目标提交
+- 核对远端 tag 是否存在且指向正确提交
+- 核对 `README.md`、`CHANGELOG.md`、`analysis/` 是否都已进入本次发布版本
+
+3.6 默认发布顺序：
+1. 更新 `README.md`
+2. 更新 `CHANGELOG.md`
+3. 检查 `analysis/` 与 `fpa` 状态一致性
+4. 提交发布相关改动
+5. 创建或更新版本 tag
+6. 推送分支与 tag 到远端
+7. 做远端发布结果复核