38 lines
4.8 KiB
Markdown
38 lines
4.8 KiB
Markdown
# 通用规范采纳记录
|
||
|
||
- 项目/负责人：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`。
|