zizi-al/muse-agent-example
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(规则): 明确分支开发、小步提交自治、统一审查与主干合并流转规范

Browse Source
This commit is contained in:
zizi 2026-09-18 23:17:14 +08:00
parent 5dec38f14a
commit 8ad28be021
3 changed files with 12 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.agent/rules/目录.md
View File

@ -8,5 +8,5 @@
| 元数据消费规则 | [元数据消费.md](元数据消费.md) | 模具归元数据、实例归业务、只增不改、投影按用途的硬规则 | 实现或评审结构定义、扩展与投影时 | 与 S04 合同联动；未知字段不静默丢弃 | | 元数据消费规则 | [元数据消费.md](元数据消费.md) | 模具归元数据、实例归业务、只增不改、投影按用途的硬规则 | 实现或评审结构定义、扩展与投影时 | 与 S04 合同联动；未知字段不静默丢弃 |
| 审校与修订规则 | [审校与修订.md](审校与修订.md) | 选区语义、不擅动正文形态、受控修订与派生失败可见 | 实现或评审修订、选段与章后处理时 | 与 B06 和正文结构合同联动 | | 审校与修订规则 | [审校与修订.md](审校与修订.md) | 选区语义、不擅动正文形态、受控修订与派生失败可见 | 实现或评审修订、选段与章后处理时 | 与 B06 和正文结构合同联动 |
| 文档与资源生成规则 | [文档与资源生成.md](文档与资源生成.md) | 生成物只由登记输入产生、索引一致、资源带发布身份 | 修改目录索引、登记资源或声明命令时 | 与 工具/维护索引.py 和 工具/构建资源包.py 联动 | | 文档与资源生成规则 | [文档与资源生成.md](文档与资源生成.md) | 生成物只由登记输入产生、索引一致、资源带发布身份 | 修改目录索引、登记资源或声明命令时 | 与 工具/维护索引.py 和 工具/构建资源包.py 联动 |
| 计划与提交 | [计划与提交.md](计划与提交.md) | 完整任务、能力依赖、双环交付、敏捷提交、研发相位与分级整体审查 | 制定 plan、委派、集成与决定提交节奏时 | Plan内敏捷小增量快跑，终验全量闭环；本地小步commit，远程与合并需授权 | | 计划与提交 | [计划与提交.md](计划与提交.md) | 分支策略、双环交付、敏捷提交、统一审查与合并门禁 | 制定 plan、委派、集成与决定提交节奏时 | 新功能分支/worktree快跑，终验后统一审查合入；小改动直提main，远程与合并需授权 |
| 子代理交付格式 | [子代理交付.md](子代理交付.md) | 三要素交付、证据指针、仅阻断级汇报、最小必读 | 派发或承接任何子代理任务时 | 报告 ≤20 行；diff/日志/指纹表只给路径 | | 子代理交付格式 | [子代理交付.md](子代理交付.md) | 三要素交付、证据指针、仅阻断级汇报、最小必读 | 派发或承接任何子代理任务时 | 报告 ≤20 行；diff/日志/指纹表只给路径 |

11
.agent/rules/计划与提交.md
View File

@ -1,4 +1,4 @@
<!-- 导航元信息: {"内容描述": "完整任务、能力依赖、双环交付、敏捷提交、研发相位与分级整体审查", "使用场景": "制定 plan、委派、集成与决定提交节奏时", "使用要求": "Plan内敏捷小增量快跑，终验全量闭环；本地小步commit，远程与合并需授权"} --> <!-- 导航元信息: {"内容描述": "分支策略、双环交付、敏捷提交、统一审查与合并门禁", "使用场景": "制定 plan、委派、集成与决定提交节奏时", "使用要求": "新功能分支/worktree快跑，终验后统一审查合入；小改动直提main，远程与合并需授权"} -->
# 计划与提交 # 计划与提交
适用于需要制定 plan 的开发任务。本文件定义任务、分工、交付批次、提交与独立审查；执行与验证节奏见[模块依赖](模块依赖.md)。计划和 Skill 均不授予提交、合并、发布或外部调用权限。 适用于需要制定 plan 的开发任务。本文件定义任务、分工、交付批次、提交与独立审查；执行与验证节奏见[模块依赖](模块依赖.md)。计划和 Skill 均不授予提交、合并、发布或外部调用权限。
@ -44,7 +44,14 @@
## 验证、提交与审查 ## 验证、提交与审查
- **验证不过不收尾**：任务未通过与自身完成标准相称的验证时，继续实现并重验受影响部分；不以“基本完成”隐去失败或推给无关后续任务。 - **验证不过不收尾**：任务未通过与自身完成标准相称的验证时，继续实现并重验受影响部分；不以“基本完成”隐去失败或推给无关后续任务。
- **本地沙盒自治（Commit early and often）**：在本地特性开发分支上，鼓励小步快跑、频繁提交，把本地 `git commit` 作为进度保存和回滚锚点，无需逐次向人类申请授权；单次提交聚焦于当前小增量产物。 - **分支策略与本地沙盒自治**：
- **新功能开发分支**：默认在主仓库切出独立特性分支进行开发，使用独立分支或 `git worktree` 隔离；
- **简易小型修改**：对于简易、小型的局部修复或修改，允许直接在主仓库（`main` 分支）进行提交；
- **敏捷小步提交（Commit early and often）**：开发过程中敏捷推进，鼓励每个小任务测试完成后即执行一次本地 `git commit` 保存检查点与回滚锚点，无需逐步向人类申请审批。
- **阶段收口与统一审查**：
- 代码审查严格基于已提交的 Git Commit 进行；
- 全部任务完成后，再集中统一进行审核（Review）并修复发现的问题，不逐笔前置卡点阻塞开发；
- 最终全量验证通过后，将特性分支（或 worktree 成果）合并回 `main` 分支。
- **关键操作授权门禁**：向远程仓库推送（`git push`）、向 `main` 主干分支合并或发起 PR、清理带有未保存改动的工作区前，必须获得用户明确授权。 - **关键操作授权门禁**：向远程仓库推送（`git push`）、向 `main` 主干分支合并或发起 PR、清理带有未保存改动的工作区前，必须获得用户明确授权。
- **审查基于 Git Commit**：代码审查严格基于已提交的 Git Commit 进行，不搞针对未提交工作树的审查；重点审查逻辑完整性、一致性、合理性、可行性，以及任务间链路与被替代实现残留。 - **审查基于 Git Commit**：代码审查严格基于已提交的 Git Commit 进行，不搞针对未提交工作树的审查；重点审查逻辑完整性、一致性、合理性、可行性，以及任务间链路与被替代实现残留。
- **整体验收不省略**：多任务或多批次计划最终必须通过全量验收（包含全量离线测试与核心集成链路），确保全局没有隐性破坏，不能仅凭各小任务局部通过代替整体验收。 - **整体验收不省略**：多任务或多批次计划最终必须通过全量验收（包含全量离线测试与核心集成链路），确保全局没有隐性破坏，不能仅凭各小任务局部通过代替整体验收。

4
AGENTS.md
View File

@ -74,7 +74,7 @@ SoT 按主题分域，不做跨主题的全局排序。可执行脚本与书面
3. **数据权威与先审后入**：数据库为唯一正式权威，严禁裸连操作；正文、规划与知识抽取默认生成 Shadow 候选，经用户明确确认后方可写入 Canonical 正典事实。 3. **数据权威与先审后入**：数据库为唯一正式权威，严禁裸连操作；正文、规划与知识抽取默认生成 Shadow 候选，经用户明确确认后方可写入 Canonical 正典事实。
4. **模型治理与受控探索**：模型调用遵守[预算管理](src/muse/任务运行/预算管理.py)的固定日界窗口（默认 Asia/Shanghai，每日00/05/10/15/20开始，末窗20至24为4小时）与受控治理链；角色允许模型与策略版本以[角色策略](配置/角色策略.yaml)为准，并遵守[角色合同](.agent/角色/角色合同.md)（写手/规划固定顶级推理模型，裁判使用独立精确白名单）；确定性逻辑、门禁与报告组装由脚本完成，严禁调用模型；智能体探索仅限圈定只读工具并留痕。 4. **模型治理与受控探索**：模型调用遵守[预算管理](src/muse/任务运行/预算管理.py)的固定日界窗口（默认 Asia/Shanghai，每日00/05/10/15/20开始，末窗20至24为4小时）与受控治理链；角色允许模型与策略版本以[角色策略](配置/角色策略.yaml)为准，并遵守[角色合同](.agent/角色/角色合同.md)（写手/规划固定顶级推理模型，裁判使用独立精确白名单）；确定性逻辑、门禁与报告组装由脚本完成，严禁调用模型；智能体探索仅限圈定只读工具并留痕。
5. **会话交互与汇报纪律**：全程使用简体中文白话，坚决去除 AI 味（直陈事实、动作与后果，禁止清嗓子套话与空转缓冲词）；需要用户决策时，必须交代清楚前因后果及各选项对下游的影响。 5. **会话交互与汇报纪律**：全程使用简体中文白话，坚决去除 AI 味（直陈事实、动作与后果，禁止清嗓子套话与空转缓冲词）；需要用户决策时，必须交代清楚前因后果及各选项对下游的影响。
6. **本地沙盒自治与关键授权**：在特性开发分支上，鼓励小步快跑（commit early and often），允许频繁在本地执行 `git commit` 保存进度检查点；仅在向远程仓库 `git push`、向 `main` 主干分支发起合并/PR 或执行破坏性操作前才需向用户明确申请授权。按[计划与提交](.agent/rules/计划与提交.md)推进，Plan 内部敏捷小增量交付，Plan 最终执行全量验收；代码审查基于已提交的 Git Commit 进行；框架与创作内容分开审查、分开提交。 6. **本地沙盒自治与分支流转**：新功能开发默认在主仓库切出特性分支（使用独立分支或 `git worktree`）；简易、小型修改可直接在主仓库（`main` 分支）提交。开发过程中敏捷推进，鼓励单个小任务测试完成后即执行一次本地 commit 保存检查点。所有任务完成后再统一进行审查（Review）并修复问题；最终全量验证通过后，将分支合并回 `main` 分支。仅在向远程仓库 `git push`、向 `main` 主干分支发起合并/PR 或执行破坏性操作前才需向用户明确申请授权。按[计划与提交](.agent/rules/计划与提交.md)推进；框架与创作内容分开审查、分开提交。
7. **计划边界与敏捷节奏**：以可独立验收的能力拆分任务，明确边界、依赖与验证方式；Plan 内部敏捷小增量交付，前置满足且有收益的独立任务分工并发，依赖任务按已验证能力衔接；Plan 终验执行全量闭环验收。具体编排、隔离和批次收尾以[计划与提交](.agent/rules/计划与提交.md)为准。 7. **计划边界与敏捷节奏**：以可独立验收的能力拆分任务，明确边界、依赖与验证方式；Plan 内部敏捷小增量交付，前置满足且有收益的独立任务分工并发，依赖任务按已验证能力衔接；Plan 终验执行全量闭环验收。具体编排、隔离和批次收尾以[计划与提交](.agent/rules/计划与提交.md)为准。
--- ---
@ -102,6 +102,6 @@ SoT 按主题分域，不做跨主题的全局排序。可执行脚本与书面
代码变更以现行架构、领域模型、ADR、规范与测试为准，保持可读、简单、局部，不凭空叠加抽象；清理和沉淀按本文件§5执行。 代码变更以现行架构、领域模型、ADR、规范与测试为准，保持可读、简单、局部，不凭空叠加抽象；清理和沉淀按本文件§5执行。
纳入版本控制：`AGENTS.md`、`docs/`、`.agent/`；实际暂存和提交仍须明确授权。 纳入版本控制：`AGENTS.md`、`docs/`、`.agent/`；遵循本地小步自治，远程推送与破坏性变更需授权。
不提交：`.agents.local/`、`.claude/`、`.codex/`、`.pi/`、`.opencode/`、`.cursor/`。 不提交：`.agents.local/`、`.claude/`、`.codex/`、`.pi/`、`.opencode/`、`.cursor/`。
<!-- my-skills-cli:end --> <!-- my-skills-cli:end -->