3.9 KiB
3.9 KiB
通用规范采纳记录
- 项目/负责人:Error-Code-System / weichen
- 状态:active
- 规范位置:
deps/development-guidelines - 规范性文档目录:
policy/(项目规则与制度放此处) - 过程文档位置:任务卡在
.task/(随 PR 维护);任务主记录在 PR;方案与验证记录仍放docs/records/(项目内固定目录豁免,理由见「项目差异」) - 版本权威:本仓 gitlink
deps/development-guidelines@2688fd2be6a5(完整 SHA2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb) - 批准/生效依据:
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),不改码值。