48 lines
8.9 KiB
Markdown
48 lines
8.9 KiB
Markdown
# 通用规范采纳记录（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)，本地与客户端/平台能力分别登记；本轮不改变分支保护或发布授权。
|