Files
Error-Code-System/policy/guidelines-adoption.md
T

4.1 KiB
Raw Blame History

通用规范采纳记录

  • 项目/负责人:Error-Code-System / weichen
  • 状态:active
  • 规范位置:deps/development-guidelines
  • 规范性文档目录:policy/(项目规则与制度放此处)
  • 过程文档位置:任务卡在 .task/(随 PR 维护);任务主记录在 PR;方案与验证记录仍放 docs/records/(项目内固定目录豁免,理由见「项目差异」)
  • 版本权威:本仓 gitlink deps/development-guidelines @ 2688fd2be6a5(完整 SHA 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb)
  • 批准/生效依据:feature/governance-adoption PR(Error-Code-System)
  • 替代范围和迁移说明:无替代。既有 AGENTS.md、PROJECT.md 与 docs/*.md 全部保留:AGENTS.md 追加「Agent 执行与新项目准入(强制)」节,PROJECT.md 验证节补充治理校验命令;docs/*.md 继续作为码格式、治理和映射的单一说明,不迁入规范库。
规范/工作流 适用条件与范围 采纳或不适用理由 执行方式/证据
core/baseline.md 日常工作 错误码是跨系统合同 manual
workflows/delivery.md、debugging.md、handoff.md 交付、排障与交接 消费方依赖稳定码 manual
standards/collaboration.md 消费方 gitlink 升级 本仓不跟踪消费方分支 manual
standards/verification.md 目录治理测试 go test 与 conformance manual
standards/module-contracts.md errcode/domains/httpx 边界 种子码集中注册 manual
standards/observability.md 稳定 code、信封、trace 头 本仓提供错误半边,日志库提供另一半 manual
standards/documentation.md 三层文档 映射文档留在本仓 docs/ manual
standards/multi-repo.md 被其他仓以 submodule 消费 本仓不嵌套那些消费方 manual
standards/failure-containment.md 未知码回落 fail-closed manual
standards/security.md 公开 message 与 reason reason 可含调用方文本,不在本库收集凭证 manual
standards/agent-execution.md 工程 Agent 执行路由、会话隔离与受控集成(AI 参与实施、修复、测试与 Review 时) 采纳:路由权威为根目录 AGENT-EXECUTION.md;共享执行器入口 scripts/agent-exec(validate / admit);禁止 host 代写实施单元 CI 工作流 .gitea/workflows/governance.yml 执行 scripts/agent-exec validate 与 scripts/dm governance check;证据:governance check + 正负例(.task/feature-governance-adoption.md)
standards/data-reliability.md 无持久化码表 码表随版本发布,不在运行时改写 不适用独立存储专题
standards/configuration.md 无多实例配置 serve 地址由 CLI 标志给出 不适用
standards/release-operations.md 无制品流水线 消费方固定 gitlink 不适用
workflows/automation.md 无后台任务 库与按需查询 不适用

项目差异

原规则/章节 项目采用方式 原因与风险 负责人/复查条件
documentation.md 过程仓默认独立仓库 docs/records/ 豁免 个人项目。docs/ 里的映射是契约说明,不是某次任务记录 对外发布码表版本时复查是否要把发布说明拆到过程记录

本次升级或首次接入验证

  • 子模块固定 deps/development-guidelines @ 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb;共享执行器 deps/development-manager @ bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c。
  • 挂载不改变 go test 行为。
  • 既有文件(AGENTS.md、PROJECT.md、AGENT-EXECUTION.md、本文件)经 governance init --adopt 保留内容;新增文件为 scripts/、.task/templates/task-card.md、.gitea/workflows/governance.yml。
  • 回退只恢复 gitlink、.gitmodules 与新增入口文件(scripts/、.gitea/workflows/governance.yml、.task/templates/task-card.md),不改码值。
  • .gitea/workflows/ci.yml 的两处 uses: actions/checkout@v4 已替换为自包含的内联检出步骤,因为 runner 无法访问 github.com;各作业的运行步骤保持不变。