Files
Agent-System-Frontend/policy/guidelines-adoption.md

4.3 KiB
Raw Permalink Blame History

通用规范采纳记录

  • 项目/负责人: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 恢复到采纳前版本。