weichen/Agent-System-Dev
1
0
Fork 0
Code Issues 1 Pull Requests 3 Actions 3 Packages Projects Releases Wiki Activity
Files
e465b7c18f5d3c576f571f6d9d2375f560ad4134
Agent-System-Dev/policy/adoption.md
T

8.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；治理 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 串行合入规则，不宣称自动互斥已经实现。
  • 过程计划固定：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 为准，流程启用以本采纳状态及项目条件为准；固定源码版本不代替实际能力证明。治理可靠性修复的命令与证据约定见 开发门禁，本地与客户端/平台能力分别登记；本轮不改变分支保护或发布授权。
Reference in New Issue View Git Blame Copy Permalink