Files
Agent-System-Core/policy/guidelines-adoption.md
T

4.8 KiB
Raw Blame History

通用规范采纳记录

  • 项目/负责人:Agent-System-Core / weichen
  • 状态:active
  • 规范位置:deps/development-guidelines
  • 规范性文档目录:policy/(本仓现有 policy/README.md;项目规则与制度放此处)
  • 过程文档位置:仓内固定目录 .task/(任务卡与任务主记录;任务主记录同时随 PR 描述维护,豁免理由见「项目差异」)
  • 版本权威:本仓 gitlink deps/development-guidelines @ 2688fd2be6a5(完整 SHA 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb);可读标签:无
  • 批准/生效依据:feature/governance-adoption PR(Agent-System-Core)
  • 替代范围和迁移说明:无
规范/工作流 适用条件与范围 采纳或不适用理由 执行方式/证据
core/baseline.md 日常工作 采纳:所有任务的硬边界、默认做法与完成声明基线 manual
workflows/delivery.md、debugging.md、handoff.md 交付、排障与交接 采纳:本仓以 PR 交付,Bug 排障与会话交接走统一流程 manual
standards/collaboration.md 并行共同起点、两级分支、节点同步与陈旧候选拒绝 采纳:PR 合入前须同步最新目标分支并附证据(见 AGENTS.md) manual;暂无真实平台负例,未登记 enforced
standards/merge-queue.md 多个就绪任务的最终同步、CI、Review 与合入调度 不适用:本仓由单一 owner 串行合入,当前无多个就绪任务竞争交付窗口;出现时另行登记 不适用
standards/agent-execution.md 工程 Agent CLI 执行路由、会话隔离与受控集成 采纳:允许 AI 协助代码实施;配置见 AGENT-EXECUTION.md AGENT-EXECUTION.md + scripts/agent-exec(validate / admit);证据:governance check 与正负例(.task/feature-governance-adoption.md)
standards/verification.md 验证与结论 采纳:完成声明须附实际命令输出 命令见 PROJECT.md「验证」节(go test ./...、git diff --check、scripts/agent-exec validate --repo .、scripts/dm governance check --repo .);CI:.gitea/workflows/governance.yml 运行治理门禁
standards/module-contracts.md、standards/multi-repo.md 公共契约(Go 类型、黄金样本、TS 镜像)的边界,以及依赖仓以 gitlink 固定版本 采纳:本仓是公共契约库,治理依赖以 gitlink 固定 manual;gitlink 与 .gitmodules 固定,CI 物化白名单见 .gitea/workflows/governance.yml;契约一致性由 conformance_test.go 与 testdata/golden 覆盖
standards/security.md CI 凭据、submodule 取回与执行工具边界 采纳:CI 仅以限定 URL 的凭据取回两个治理 gitlink,凭据不落盘 manual;.gitea/workflows/governance.yml 白名单与凭据约束
workflows/design-verification.md、standards/testability.md 契约增量的设计与验证、纯函数的可独立测试性 采纳:契约变更按增量设计验收,并以黄金样本与一致性测试验证 manual;conformance_test.go、testdata/golden
standards/failure-containment.md、data-reliability.md、observability.md、configuration.md、release-operations.md、automation.md 运行时服务、数据库、部署发布、定时自动化与故障控制 不适用:本仓只含契约与纯函数,不含 I/O、数据库或运行服务,不独立部署(见 PROJECT.md) 不适用

项目差异

原规则/章节 项目采用方式 原因与风险 负责人/复查条件
过程文档默认放独立过程仓 任务卡与任务主记录放仓内 .task/,AGENT-EXECUTION.md 的 exempt_paths 已豁免 .task/** 单一 owner 的小仓库,过程记录体量小,独立过程仓成本不划算;风险是过程记录与代码同仓,禁止写入凭据或 token weichen;协作人增加或过程记录需跨仓共享时复查

本次升级或首次接入验证

  • 入口:AGENTS.md 保留原内容并追加「Agent 执行与新项目准入(强制)」;PROJECT.md「验证」节补充 scripts/agent-exec validate --repo . 与 scripts/dm governance check --repo .;AGENT-EXECUTION.md 原样保留(governance init --adopt 跳过已存在文件)。
  • 版本获取:deps/development-guidelines @ 2688fd2be6a5,deps/development-manager @ bd3a7de57a3a;.gitmodules 使用规范 SSH 地址,不含凭证或本机路径。
  • 占位符:模板占位符已全部替换;policy/guidelines-adoption.md 与追加的准入段中不再有模板尖括号文字。
  • 冲突检查:仓内原无其他采纳记录(无 policy/adoption.md),原无旧版 Agent 执行入口(无 scripts/agent_exec.py),原无 .gitea/workflows,治理 workflow 为新增,无需修改既有 CI。
  • 正负例与 Review/CI 证据:见 .task/feature-governance-adoption.md。