用途:MCAF 是一个可选的仓库治理层,仅在用户明确要求采用 MCAF 或修改 MCAF 规则时使用,不作为普通 .NET 工作的路由,也避免与其他实现或流程技能重复。
主要能力:在根 AGENTS.md 及受影响的本地 AGENTS.md 中建立或收紧治理规则;只保留未来贡献者和智能体必须知道的持久规则;把规则放在其归属的领域旁;当子树确有差异时才添加本地 AGENTS.md;记录仓库依赖的构建、测试、格式、分析和运维命令;将实现工作交给最贴近实际技术或行为的常规技能。
使用方式:先确认请求确实涉及采用 MCAF 或修改 MCAF 治理;编辑前完整阅读根 AGENTS.md 和所有受影响的本地 AGENTS.md;验证变更后的策略、文档链接和仓库命令。仓库声明遵循 MCAF 1.3 时,需保留上游强制策略:MCAF-ARCH-001(单一仓库、统一垂直切片身份)、MCAF-GOV-001(合并而非覆盖或弱化现有规则)、MCAF-REQ-001(稳定需求与验收标准映射到自动化测试或明确证据例外,并链接 ADR 实现契约)、MCAF-AI-001(非平凡工作使用有能力且可验证的规划/集成负责人)。
适用场景:单仓库或多项目 MCAF 解决方案的治理规则调整;为每个项目或模块根维护入口点、边界、命令、适用技能和本地风险。
限制:不得向未选择 MCAF 的仓库注入这些策略;更新现有 MCAF 仓库时保留更严格的本地规则,遇到真实冲突应报告而非弱化;不要施加通用敏捷仪式、分支命名、UI/UX 选择、入职模板、NFR 目录或 ML 流程;不要以 MCAF 命名空间复制测试、CI、文档、安全、可观测性或架构技能;不要发明超出已采用 MCAF 版本的规划产物;不要在治理之外增加超过其澄清决策或行为规模的过程产物。仅在仓库引导采用 MCAF 时阅读 references/adoption.md。验证要点:每条新规则持久、有范围且有仓库表面归属;不重复常规实现技能;引用命令和路径存在;MCAF 1.3 仓库保留四项强制策略或记录显式版本化迁移状态;采用上游验证器时 scripts/verify-mandatory-policies.sh 通过;移除或重命名的 MCAF 表面不留下悬空引用。