8.9 KiB
8.9 KiB
通用规范采纳记录(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.112f5b19872be2a4597838a4131ad75d1be089ee5e(Guidelines PR #5)。Dev 采用 manual 串行合入规则,不宣称自动互斥已经实现。 - 过程计划固定: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 实施单元 为准(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(默认采纳):通用规则供应商无关,留在共享规范与 有界单元包、上下文与阶段交接;模型偏好只是 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(见 本地记录与独立证据),二者分别登记。
- 规则采纳、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 保留阶段产物和验证,移除逐阶段人工签字;目标、范围和终点一次确认后,智能体连续完成范围内交付,只在结果变更、重大取舍、高后果操作或用户专属验收时请求决策 | 2026-10-15 用户要求目标优先、绝不私自扩围、先可用再迭代,并移除可移除的人工环节;独立 Review、证据、平台准入和高后果双钥匙保留 | weichen;目标/授权边界、Review、CI 或平台准入条件变化时复查 |
- 历史记录(2026-09-30)报告 11 个组合仓 main 禁直推、拒绝陈旧候选;当前平台能力须独立重验,本地脚本测试不替代远端证据。
- 规范源码以 gitlink 及其 VERSION 为准,流程启用以本采纳状态及项目条件为准;固定源码版本不代替实际能力证明。治理可靠性修复的命令与证据约定见 开发门禁,本地与客户端/平台能力分别登记;本轮不改变分支保护或发布授权。