用途
本技能用于将架构与结构质量的意图转化为可执行的检查，防止新的架构漂移，而不是依赖反复的文字警告。它同时负责仓库契约与质量维护，因为两者使用同一套机制：可收集规则、diff 门禁、审计报告、基线与逐步减债。
何时使用
- 用户要求定义、保护、审计或编码架构边界、目录归属、咽喉点、白名单、基线或契约。
- 仓库已有分层规则，但智能体仍添加绕过调用或错误依赖。
- 用户要求结构指标、质量报告、债务阈值、回归预算或渐进清理循环。
- 需要区分 diff 检查与全量审计检查。
所需输入
- 架构文档或预期分层。
- 当前目录结构与已知历史债务。
- 需要保护的规则：依赖方向、文件大小、公共入口点、数据访问、接口边界或类似约束。
- 现有质量报告、生成的快照，以及 CI 或定时运行策略。
执行顺序
- 首先：阅读架构文档、当前代码、现有检查、报告与基线，识别真实边界与债务。
- 然后：设计机械规则、可收集指标、diff 检查、审计报告、基线与白名单。
- 最后：输出可执行契约、生成的证据，以及渐进收敛策略。
分步流程
- 搜索 ARCHITECTURE.md、契约文档、lint 脚本、基线文件与白名单。
- 列出受保护规则；每条规则必须可由脚本或评审检查。
- 如果架构或契约表面缺失，从 references/build-when-missing.md 引导最小文件与检查器形态。
- 将新漂移与历史债务分开：新漂移应失败，历史债务应进入基线。
- 只添加与具体结构风险相关的指标；保持可自动收集，避免聚合质量分数。
- 设计 --mode diff 用于变更文件，--mode audit 用于全仓库报告。
- 对每个违规，输出路径、规则或指标、当前值、阈值、原因与建议方向。
- 定义基线或白名单何时可以变更、谁拥有生成的快照，以及需要什么偿还说明。
检查项
- 机械性：每条规则可由 AST、正则、导入图、路径扫描或报告脚本检查。
- 基线：历史债务显式存在，不被虚假的绿色状态隐藏。
- Diff：新变更可被低成本阻止。
- 例外：白名单条目有负责人、原因与收敛计划。
- 指标：每个质量指标可重复，且代表真实结构风险。
- 快照：生成的报告注明其来源命令，不能静默过期。
- 激励：没有聚合分数掩盖关键发现。
- 过度构建：当清晰脚本足够时，不要使用复杂平台。
输出格式
Repo Contracts And Boundaries
Detected Mapping
- architecture:
- contracts:
- quality:
- validation:
Protected Boundaries
Diff Checks
Audit Checks
Baseline / Allowlist Policy
Generated Reports / Snapshots
Garden Loop
Failure Message Shape
Rollout Plan
常见错误
- 跳过基线，导致检查因历史债务永久变红。
- 只运行审计，仍让智能体引入新漂移。
- 将无法机械检查的架构建议当作规则。
- 跟踪无法重复收集的指标。
- 发布掩盖关键风险的漂亮总分。
- 编写不告诉智能体如何修复违规的失败消息。
示例提示
- “把这个项目的架构边界变成检查。”
- “为这个仓库设计一个 diff/audit 契约检查器。”
- “我们应该如何冻结对这些历史咽喉点的新依赖？”
- “跟踪结构债务，但不要发明虚假的质量分数。”
限制
资料未提供具体的收费、价格、平台支持范围或效果保证信息。