Files
Agent-System-Dev/policy/adoption.md
T

6.9 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.12,实际合入提交 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb(Guidelines PR #7);本仓 gitlink(deps/development-guidelines)固定该源码版本,版本权威为父仓 gitlink。
  • 合入调度通用版本:0.1.0-draft.11,实际合入提交 2f5b19872be2a4597838a4131ad75d1be089ee5e(Guidelines PR #5);draft.12 未修改其合入调度文件(standards/merge-queue.md、templates/merge-queue.md)。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(项目收紧) 需求、长期方向、试验、实施迭代及交付 goal-first:目标/范围/终点一次确认,范围内连续推进验证、Review、合入和安全收口;实施写入按 agent-per-unit(配置 AGENT-EXECUTION.md;实施/修复/测试正常候选仅为 Cursor、agy、PI,每候选对安全可恢复失败最多 3 次全新尝试,全部安全耗尽后一次 Codex CLI 紧急尝试;Codex 平时只用于规划、设计、计划或独立 Review;显式 fail-stop 立即停止;不限制推理时长、工具次数、规划方式或首次写文件时间;集成须成功 transport 的 agent-exec apply,或 pre-commit admit 精确内容来源;host 豁免仅为 .task/** 与 docs/superpowers/specs/、plans/;host 不直接实施;fallback_to_host 为 never;安全耗尽不发出 host-fallback-authorized,终态为 unavailable 或 blocked);仅真实决策点需人工;任务卡提供记录,post-merge 默认只提示,行为回归见 tests/test_task.py
AGENT-EXECUTION.md + agent-exec 项目执行路由 本地 SELF:parser/adapter/controller 假 CLI 契约由共享执行器自身测试强制(Development-Manager internal/agentexec,经 deps/development-manager 钉住),并由 CI 中的 scripts/agent-exec validate --repo . 覆盖;本地薄入口拒绝路径由 tests/test_agent_exec_entry.py 强制;已安装 provider/model 真实身份待 U5 探针,此前不接受为已就位;远端平台准入仍为 GATE
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 不是原子锁,平台保护仍承担最终准入
draft.12 工程 Agent 执行标准、终态收据 Schema、两级交付与分流(硬边界 8、agent-execution、A8) 实施、交付、分流与 PR 目标;任务启动前 active/manual:make task-triage 收据为 make task-start … TRIAGE_RECEIPT=… 的前置,远端不可核验时 REMOTE_UNVERIFIED(exit 6)并拒绝建分支;child PR 由 make task-pr-check 本地核验与 CI PR base gate 门禁;AGENT-EXECUTION.md 已声明 integration 块。draft.12 Schema 正负例与平台侧负例在项目中的真实运行本次未执行(NOT_RUN),不由本行推断

项目差异

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