43 lines
4.4 KiB
Markdown
43 lines
4.4 KiB
Markdown
# 通用规范采纳记录
|
||
|
||
- 项目/负责人：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`、本文件）经 `governance init --adopt` 保留内容；新增文件为 `AGENT-EXECUTION.md`、`scripts/`、`.task/templates/task-card.md`、`.gitea/workflows/governance.yml`。
|
||
- 回退只恢复两个 gitlink 与 `.gitmodules` 条目（`deps/development-guidelines` 回到 R0 固定值 `26b562d2e34f`，`deps/development-manager` 移除），删除本 PR 新增的 `scripts/dm`、`scripts/agent-exec`、`scripts/task`、`scripts/hooks/pre-commit`、`.gitea/workflows/governance.yml`、`.task/templates/task-card.md`、`AGENT-EXECUTION.md`，移除 `AGENTS.md`、`PROJECT.md` 中追加的节，并将 `.gitea/workflows/ci.yml` 的两处检出步骤恢复为 `uses: actions/checkout@v4`；不改码值。
|
||
- `.gitea/workflows/ci.yml` 的两处 `uses: actions/checkout@v4` 已替换为自包含的内联检出步骤，因为 runner 无法访问 github.com；各作业的运行步骤保持不变。
|