Files
Agent-System-Dev/policy/adoption.md
T
weichen 3a2ede584c Simplify parallel branch merge coordination
Why: Keep branches developing independently and serialize only final sync, validation, and agent merge without expanding into audits or new platform mechanisms.

Evidence: scope and link checks, git diff --check, and recursive worktree verification passed as SELF evidence in the task card.

Impact: Documentation only; existing task-sync, CI, branch protection, and agent merge behavior remain unchanged.

Refs: Agent-System-Dev #518
2026-10-14 16:36:13 +00:00

4.8 KiB
Raw Blame History

通用规范采纳记录(Agent-System-Dev 组合)

  • 项目/负责人:Agent-System 组合 / weichen
  • 状态:active(2026-09-30 经 PR weichen/Development-Guidelines#1 采纳 draft.7;机制经 Dev PR#1 合入 ef89fc8)
  • 规范位置:deps/development-guidelines(gitlink 固定版本)
  • 过程文档位置:modules/documents(docs/records/)
  • 版本权威:父仓 gitlink
  • 批准/生效依据:Dev PR#1(19/19 正负例 + make test);guidelines PR#1
  • 合入调度通用版本:0.1.0-draft.11,实际合入提交 2f5b19872be2a4597838a4131ad75d1be089ee5e(Guidelines PR #5);本仓 gitlink 固定该源码版本。Dev 采用 manual 串行合入规则:并行开发,轮到后才同步、跑最终 CI 并由智能体合入。该规则不要求先完成全写者审计或第二轮试行,也不宣称自动互斥已经实现。
  • 过程计划固定:Documents PR #96 实际合入 129cc3579d9c9e3edfb46c99270d65f3e1dad0a0,包含既有主干文档及获批 U1–U6 计划;当前进展以任务/PR 记录为准。
规范/工作流 适用条件与范围 执行方式/证据
core/baseline.md 日常 manual
workflows/delivery.md(含启动自检 §1) 交付 本地命令检查;首次收据与 BUSY/SYNC/REMOTE_UNVERIFIED 语义见 policy/governance.md
standards/collaboration.md 并行/同步节点 enforced(本地命令):分支、现场、组件检查;task-sync 实际合并时记录,同基线只核验。最终平台与阶段授权另验
提交格式(主题行/四段 body) 全部提交 主题行 enforced(local),body manual;任务工具生成四段 body,历史 PR 仅作旧版本证据
standards/verification.md 验收 本地 make test-governance + 组合测试;当前证据与历史 scratch 记录分开
standards/multi-repo.md 跨仓/gitlink manual;受控历史迁移通道已于 2026-09-30 行使一次(documents/records/2026-09-30-history-migration.md)
工作区回收 交付终点 advisory(task-finish);负例:合入前 finish 拒绝输出
policy/delivery.md(项目收紧) 需求、长期方向、试验、实施迭代及交付 manual(人工/Agent 执行):前序人工决策与有范围的连续推进授权;智能体完成 Review、冲突处置和当前 HEAD 的 CI 核验后合入;任务卡提供记录,post-merge 默认只提示,行为回归见 tests/test_task.py
standards/tool-adaptation.md(draft.8) 为工具创建规则/钩子实例 本组合 CLI/git 级实例已登记:policy/tool-adaptation-matrix.md(A1–A7 逐行定级+正负例证据)
同上(zcode 实例) zcode 客户端写路径 policy/tool-adaptation-zcode.md:PreToolUse 写守卫;脚本负例与客户端接线分开,客户端 pending-live
core/baseline.md「规范层级」+ documentation.md「记忆分层/机制化」(draft.9) 层级效力、记忆权威、经验机制化 manual:本仓 policy/ 仅收紧不放宽;记忆四层按条文执行(任务卡=任务记忆,documents/records=项目记忆,Dev 仓 AGENTS.md 指针已就位)
draft.11 合入调度 active/manual;Dev main 使用 #518 排序和单一最终窗口 等待分支不追 main;窗口任务同步一次、固定 HEAD、跑当前必需 CI、由智能体合入并回读结果。Issue 不是原子锁,平台保护仍承担最终准入

项目差异

原规则/章节 项目采用方式 原因与风险 负责人/复查条件
baseline 硬边界 1(授权范围) 高后果双钥匙:改写历史/解除分支保护/删归档/发布——Agent 只准备,用户执行(AGENTS.md 条文) 单人+Agent 场景下消除单点;风险=用户不在场时高后果操作排队 weichen;首次触发时复查
delivery.md §2、design-verification.md 的轻量流程默认做法 按 policy/delivery.md 保留需求、方案、实施与验收的人工节点;代码 Review 与 PR 合入交由智能体,冲突解决且当前 HEAD 的 CI 通过后合入;小任务简化篇幅,阶段内可迭代 2026-10-12 用户明确要求智能体 Review 后合入,合入前解决冲突且 CI 通过;其他人工决策与高后果双钥匙边界保留 weichen;Review、CI 或平台准入条件变化时复查
  • 历史记录(2026-09-30)报告 11 个组合仓 main 禁直推、拒绝陈旧候选;当前平台能力须独立重验,本地脚本测试不替代远端证据。
  • 规范源码以 gitlink 及其 VERSION 为准,流程启用以本采纳状态及项目条件为准;固定源码版本不代替实际能力证明。治理可靠性修复的命令与证据约定见 开发门禁,本地与客户端/平台能力分别登记;本轮不改变分支保护或发布授权。