# 通用规范采纳记录(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;治理 kit 采纳——Dev PR #602(merge `f563ed612a9574e798ee3421c010a9e2ceb416a0`,归档卡 `.task/archive/feature-governance-v2-closeout.md`);当前固定版本随 feature/norm-remediation 交付,Review/CI 以该交付 PR 的 exact-head 记录为准 - 规范源码版本:`0.1.0-draft.14`,Guidelines PR #11(含 U1 #10)合入提交 `a15db5085585f199c3c399824f6cf24c3144bbd5`;本仓 gitlink(`deps/development-guidelines`)固定该提交,版本以其 VERSION 为准,版本权威为父仓 gitlink。 - 共享执行器版本:`deps/development-manager` 固定 Development-Manager PR #27(含 #26 单写者提示)合入提交 `6c019595fa02aa2d0a1a9b8f98fc224e69d2a901`;首次治理 kit 采纳时为 `0552b7358d6955057d6eea090326f83317ed992a`(Dev PR #602)。 - 历史固定版本:draft.12 `2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb`(Guidelines PR #7);合入调度通用条文首次采纳于 draft.11 `2f5b19872be2a4597838a4131ad75d1be089ee5e`(Guidelines PR #5)。Dev 采用 [manual 串行合入规则](delivery.md#合入调度),不宣称自动互斥已经实现。 - 过程计划固定: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,候选、尝试上限、fail-stop、集成来源与 host 豁免以 [AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 和 [Agent 实施单元](delivery.md#agent-实施单元与主模型职责) 为准(`fallback_to_host` 为 never)。任务卡提供记录,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 强制。模型身份逐次运行区分 requested/effective,CLI 未报告时记 not-observable,不视为已就位;远端平台准入仍为 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` 块。规则采纳不等于各 Schema 用例已在项目中运行,见下节 | | draft.14:有界单元包、上下文预算与阶段交接(standards/agent-execution.md、workflows/handoff.md) | 实施、修复、测试与 Review 单元的派遣和跨阶段交接 | active/manual(默认采纳):通用规则供应商无关,留在共享规范与 [有界单元包、上下文与阶段交接](delivery.md#有界单元包上下文与阶段交接);模型偏好只是 [AGENT-EXECUTION.md](../AGENT-EXECUTION.md) 的项目配置,不是路由角色。上下文容量未知、无自动压缩或 CLI 未登录只作事实记录,不构成全局停止;不新增 fail-close 或强制门禁 | ## 采纳证据与未运行项 - 历史正例与四类负例(SELF,非本次新运行):Dev PR #602 归档卡 `.task/archive/feature-governance-v2-closeout.md` 的 evidence 收据记录 `python3 docs/superpowers/plans/evidence/governance-adopt-cases.py .` 在源提交 `271d95ff688a1104f1717f19a7d3458332059dc6`(后于 `437a32ead266c0ab56053f2749e2a34f4ecfc177` 重放)ALL PASS 5 例:`positive-run-apply`(success 后 apply 成功)、`missing-config`(invalid-config)、`bad-receipt`(无效收据,apply 拒绝且 HEAD 不变)、`out-of-scope-path`(scope-expansion、无 transport)、`unknown-side-effect`(failed-unknown、无 transport)。该 PR 头 `0e27c7b5d70bdcebf063379845d0384fbb72f718` 的必需 CI(run 3684)只是当时那个 head 的 GATE,不成为当前 exact-head GATE。 - 来源分层:agent-exec apply/admit 的本地完整性记录(HMAC)只证明内容来源,属 SELF;交付信任仍来自精确 HEAD 的必需 CI 与独立 Review(见 [本地记录与独立证据](governance.md#本地记录与独立证据)),二者分别登记。 - 规则采纳、manual/advisory 执行能力与逐例证据分开登记:缺少与上述用例无关的额外用例不使既有 active 记录失效,也不据此宣称新的强制能力。 - NOT_RUN:draft.12/draft.14 Schema 正负例与平台侧负例在本项目中的新运行;真实模型的采纳前后质量对比测试。 ## 项目差异 | 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 | |---|---|---|---| | baseline 硬边界 1(授权范围) | 高后果双钥匙:改写历史/解除分支保护/删归档/发布——Agent 只准备,用户执行(AGENTS.md 条文) | 单人+Agent 场景下消除单点;风险=用户不在场时高后果操作排队 | weichen;首次触发时复查 | | delivery.md §2、design-verification.md 的轻量流程默认做法 | 按 [policy/delivery.md](delivery.md) 保留阶段产物和验证,移除逐阶段人工签字;目标、范围和终点一次确认后,智能体连续完成范围内交付,只在结果变更、重大取舍、高后果操作或用户专属验收时请求决策 | 2026-10-15 用户要求目标优先、绝不私自扩围、先可用再迭代,并移除可移除的人工环节;独立 Review、证据、平台准入和高后果双钥匙保留 | weichen;目标/授权边界、Review、CI 或平台准入条件变化时复查 | - 历史记录(2026-09-30)报告 11 个组合仓 main 禁直推、拒绝陈旧候选;当前平台能力须独立重验,本地脚本测试不替代远端证据。 - 规范源码以 gitlink 及其 VERSION 为准,流程启用以本采纳状态及项目条件为准;固定源码版本不代替实际能力证明。治理可靠性修复的命令与证据约定见 [开发门禁](governance.md),本地与客户端/平台能力分别登记;本轮不改变分支保护或发布授权。