4.3 KiB
4.3 KiB
通用规范采纳记录
- 项目/负责人:Agent-System-Frontend / weichen
- 状态:active
- 规范位置:
deps/development-guidelines - 规范性文档目录:
policy/(项目规则与制度放此处;入口为policy/README.md) - 过程文档位置:任务卡在
.task/(如.task/feature-governance-adoption.md);任务主记录为对应 PR 描述 - 版本权威:本仓 gitlink
deps/development-guidelines @ 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb;可读标签:无(候选0.1.0-draft.12,尚未发布) - 批准/生效依据:
feature/governance-adoption PR(Agent-System-Frontend) - 替代范围和迁移说明:无替代既有采纳记录。遗留:
policy/README.md与PROJECT.md的采纳基线行仍写有旧路径development/guidelines(指向 Dev 仓),本次未改,后续单独修正为本仓 gitlink。
| 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
|---|---|---|---|
| core/baseline.md | 日常工作 | 采纳:所有任务的硬边界、授权与完成声明基线 | manual |
| workflows/delivery.md、debugging.md、handoff.md | 交付、排障与交接 | 采纳:本仓日常交付、Bug 排障与会话交接均按此执行,任务卡与 PR 为记录载体 | manual |
| standards/collaboration.md | 并行共同起点、两级分支、节点同步与陈旧候选拒绝 | 采纳:存在 feature 分支并行开发,合入前需同步最新目标分支 | manual;有真实平台负例再登记 enforced |
| standards/merge-queue.md | 多个就绪任务的最终同步、CI、Review 与合入调度 | 不适用:单 owner、单仓串行合入,无共享 CI 预算或多任务合入窗口 | 不适用 |
| 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 | 验证与结论 | 采纳:功能与修复的验收须附实际命令输出 | manual;本地命令见 PROJECT.md「验证」节(CI 仅运行治理检查) |
| standards/module-contracts.md | 模块边界、公开接口与契约测试 | 采纳:src/ 模块与 Core 契约形状测试(vitest)遵循该契约 |
manual |
| workflows/design-verification.md | 功能增量的设计与验收对应 | 采纳:新功能与跨模块变更须写明验收与验证范围 | manual |
| standards/testability.md | 模块测试、mock 边界与可独立验证的设计 | 采纳:单元与契约测试依赖保持最小,真实适配器单独验证 | manual |
| standards/failure-containment.md | 故障影响控制、运行配额与故障注入 | 不适用:本仓为前端 SPA(构建产物由后端内嵌),无自有服务进程、队列或持久化,故障影响控制由后端仓承担 | 不适用 |
项目差异
| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| 无 | 无 | 无 | 无 |
默认做法差异说明理由;硬边界冲突须有明确有效决策,不能用此表自授权。建议不采用无需登记。
本次升级或首次接入验证
- 入口:
AGENTS.md(治理入口,合并 Guidelines 短入口与本仓「Agent 执行与新项目准入」)、AGENT-EXECUTION.md、PROJECT.md、本文件;相对链接指向deps/development-guidelines/...,目标文件已在固定 SHA 中核对存在。 - 占位符:本文件与
AGENTS.md中的模板占位符已全部替换。 - 版本获取:
governance init --adopt(dm-server bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c)以固定 SHA 检出deps/development-guidelines(2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb)与deps/development-manager(bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c)。 - 冲突检查:既有
AGENTS.md、PROJECT.md、AGENT-EXECUTION.md原样保留;本仓无其他采纳记录(如policy/adoption.md),无需引用。 - 正负例与 Review/CI 证据:见
.task/feature-governance-adoption.md「结果与验证」节。 - 回退:删除
.gitmodules中两个治理条目及deps/gitlink,并移除本次生成的治理脚本与.gitea/workflows/governance.yml;AGENTS.md、PROJECT.md恢复到采纳前版本。