6.2 KiB
6.2 KiB
通用规范采纳记录
- 项目/负责人：Agent-System-Documents / weichen
- 状态：active
- 规范位置：
deps/development-guidelines（gitlink，见下方版本权威） - 规范性文档目录：
policy/（本仓当前仅含本采纳记录，无其他规范性文档；项目规则与制度放此处） - 过程文档位置：过程记录保存在本仓
docs/固定目录，不另设独立过程仓库：实施记录docs/records/、设计方案与计划docs/proposals/（索引docs/proposals/INDEX.md）、测试报告docs/reports/、使用报告与插件开发指南docs/guides/，目录入口见README.md（仓内固定目录的登记见下方项目差异表）；.task/仅为治理交付流程的任务卡与证据位置（随 PR 维护），任务主记录在 PR 描述中 - 版本权威：本仓 gitlink
deps/development-guidelines@2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb（可读标签：无，固定提交的 VERSION 为 0.1.0-draft.12） - 批准/生效依据：
feature/governance-adoptionPR（Agent-System-Documents） - 替代范围和迁移说明：无。既有 AGENTS.md、PROJECT.md、AGENT-EXECUTION.md、docs/ 与 .task/ 全部保留，不替代、不迁移历史记录。
| 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
|---|---|---|---|
| core/baseline.md | 本仓全部工作（文档、治理与任务交付） | 适用：所有变更遵循其强度与授权定义 | manual；AGENTS.md 入口 |
| workflows/delivery.md、debugging.md、handoff.md | 交付（任务卡 + PR）、排障、跨会话交接 | 适用：交付经 .task/ 任务卡与 PR 进行；交接状态写入任务主记录 |
manual；AGENTS.md 与 .task/feature-governance-adoption.md |
| standards/collaboration.md | 并行共同起点、两级分支、节点同步与陈旧候选拒绝 | 适用：AGENTS.md 启动门禁要求从权威 origin/main 固定起点并同步 | manual；AGENTS.md 启动门禁与任务卡同步记录 |
| standards/merge-queue.md | 多个就绪任务同一目标分支的串行交付调度 | 不适用：本仓不单独维护同一目标分支的多任务交付队列，本仓自身的交付不经队列调度。本仓存放的合入调度试行记录 docs/records/2026-10-14-merge-queue-trial.md 与实施计划 docs/proposals/2026-10-13-merge-queue-implementation-plan.md 记录的是 Agent-System-Dev 的调度（依据 Dev 仓 policy/merge-queue.md 与 Dev #518），本仓仅以文档形式保存 |
不适用 |
| standards/agent-execution.md | 工程 Agent CLI 执行路由、会话隔离与受控集成 | 适用：允许 AI 协助文档与治理变更，必须采纳；配置见 AGENT-EXECUTION.md | AGENT-EXECUTION.md + scripts/agent-exec（validate / admit）；证据：governance check 与 CLI 正负例（.task/feature-governance-adoption.md） |
| standards/verification.md | 验证与结论 | 适用：本仓无可编译程序，验证以文档检查与治理检查为主 | git diff --check、scripts/dm governance check --repo .、scripts/agent-exec validate --repo .（PROJECT.md 验证节）；.gitea/workflows/governance.yml |
| standards/documentation.md | 文档结构、相对链接、版本与引用一致性 | 适用：本仓即系统文档仓（docs/ 与 README 目录） | manual；PROJECT.md 验证节 |
| standards/multi-repo.md | 跨仓 gitlink 与组合验证 | 适用：Development-Guidelines 与 Development-Manager 以 gitlink 挂载，gitlink 变更须经 Dev 仓组合验证后推进 | manual；AGENTS.md 仓内规则 |
| standards/security.md | 凭证与秘密不入仓 | 适用：AGENTS.md 规定 token 不入仓、不回显、不写入产出物 | manual；AGENTS.md Gitea 访问事实节 |
| workflows/design-verification.md、standards/testability.md、standards/failure-containment.md | 功能增量的设计/验证、模块测试与故障控制 | 不适用：本仓不含产品代码、运行服务或业务测试套件（见 PROJECT.md 验证节） | 不适用 |
| standards/module-contracts.md、observability.md、data-reliability.md、release-operations.md、configuration.md、tool-adaptation.md | 业务模块契约、观测、数据可靠性、发布运维、运行配置、工具适配 | 不适用：本仓无业务模块、运行服务、发布制品或运行配置；模块边界如出现时再启用 | 不适用 |
项目差异
| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| standards/documentation.md 过程记录位置 | 登记为仓内固定目录豁免：过程记录保存于 docs/records/、docs/proposals/、docs/reports/、docs/guides/（按 README.md 目录），任务卡与证据保存于 .task/；不另设独立过程仓库 |
本仓即系统文档与过程记录仓（见 README.md），过程记录本身是其内容，拆出独立仓会使文档与其引用的实施记录分离。风险：规范文档与过程记录同仓，需依靠目录边界与 docs/proposals/INDEX.md 区分 |
weichen；复查条件：建立独立过程仓库，或 Development-Guidelines 固定版本变更过程记录位置规则时复查 |
默认做法差异说明理由；硬边界冲突须有明确有效决策，不能用此表自授权。建议不采用无需登记。
本次升级或首次接入验证
本次为首次接入，采用 governance init --adopt 固定 Development-Guidelines 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb 与 Development-Manager bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c。既有 AGENTS.md、PROJECT.md、AGENT-EXECUTION.md 保留，新增治理文件见 scripts/、.gitea/workflows/governance.yml、.task/templates/task-card.md。正负例与 governance check、agent-exec validate 的输出证据记录于 .task/feature-governance-adoption.md。
回退方式：删除两个 gitlink（deps/development-guidelines、deps/development-manager）、.gitmodules、scripts/、.gitea/workflows/governance.yml、.task/templates/task-card.md 与本记录，并撤销 AGENTS.md 与 PROJECT.md 中新增的段落。回退前须确认不再有任务依赖 scripts/agent-exec 路由。