3.9 KiB
3.9 KiB
通用规范采纳记录
- 项目/负责人:Agent-System-Backend / weichen
- 状态:active
- 规范位置:
deps/development-guidelines - 规范性文档目录:
policy/(项目规则与制度放此处,含policy/modules/模块卡;policy/README.md为既有项目规范索引) - 过程文档位置:
.task/(任务卡,随 PR 维护);任务主记录在 PR 描述中 - 版本权威:本仓 gitlink
deps/development-guidelines@2688fd2be6a5;可读标签:无 - 批准/生效依据:
feature/governance-adoptionPR(Agent-System-Backend) - 替代范围和迁移说明:无
| 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
|---|---|---|---|
| core/baseline.md | 日常工作 | 采纳:本仓日常开发的基线规则,AGENTS.md 已引用 | manual |
| workflows/delivery.md、debugging.md、handoff.md | 交付、排障与交接 | 采纳:AGENTS.md 已引用交付、排障与交接入口 | manual |
| standards/collaboration.md | 并行共同起点、两级分支、节点同步与陈旧候选拒绝 | 采纳:AGENTS.md 任务启动门禁与验收/合入前同步要求 | manual;暂未登记 enforced,有真实平台负例后再登记 |
| standards/merge-queue.md | 多个就绪任务的最终同步、CI、Review 与合入调度 | 不适用:本仓当前无多任务并行合入队列,合入仍按单 PR 经 CI 与 Review 进行 | 不适用 |
| 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 vet ./...、go test -count=1 ./...(.gitea/workflows/ci.yml);scripts/agent-exec validate --repo .、scripts/dm governance check --repo .(.gitea/workflows/governance.yml) |
| workflows/design-verification.md、standards/testability.md、standards/failure-containment.md | 功能增量的设计/验证、模块测试与故障控制 | 采纳:模块隔离档位与升级条件由 policy/modules/ 模块卡记录 | manual;证据:policy/modules/*.md、PROJECT.md「验证」节 |
项目差异
| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| 任务启动门禁(scripts/task start) | 保留 AGENTS.md 既有的 Dev 仓 make precheck / make task-start 流程;scripts/task 作为共享入口并存 |
本仓作为子仓随父仓编排,启动动作由 Dev 仓承担;两条入口并存的风险是启动记录分散 | weichen;在本仓独立验证 scripts/task start 后复查并统一 |
默认做法差异说明理由;硬边界冲突须有明确有效决策,不能用此表自授权。建议不采用无需登记。
本次升级或首次接入验证
- 入口与相对链接:AGENTS.md、PROJECT.md、AGENT-EXECUTION.md、policy/guidelines-adoption.md 中的
deps/development-guidelines链接指向 gitlink 固定版本。 - 版本获取:
dm-server governance init --adopt(DM 固定版本bd3a7de)检出deps/development-guidelines@2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb,检出deps/development-manager@bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c。 - 冲突检查:init 以 adopt 模式运行,AGENTS.md、PROJECT.md、AGENT-EXECUTION.md 为 kept,未覆盖既有内容;AGENTS.md 仅追加「Agent 执行与新项目准入(强制)」节。
- 占位符:本记录已替换全部模板占位符。
- 门禁正负例:见 .task/feature-governance-adoption.md(PR 取证后回填)。
- 回退:移除
.gitea/workflows/governance.yml、scripts/目录、.task/templates/task-card.md,并回退两条 gitlink 及.gitmodules中对应条目;AGENTS.md 中追加的节同步删除。