Project Change Router Skill

中文默认版。英文版见 README.en.md。

project-change-router 是一个面向大型仓库的 AI coding skill，可用于 Codex、Claude Code 和 DeepSeek Harness。它的目标不是让 agent 更大胆地猜架构，而是让 agent 更少乱猜：在真正修改代码之前，先用仓库本地的路由 bundle 获取能力归属、canonical root、owner、读写边界、复用风险和处理倾向。

它解决的核心问题是大型项目开发中常见的结构漂移：

• agent 上下文有限，不可能每次完整读取大型全栈项目。
• agent 注意力会漂移，容易只根据局部文件和名字相似做判断。
• 可复用能力可能被重复实现，形成第二套平行中心。
• 本该进入底层共享能力的代码可能被写到 facade、API、UI 或临时目录里。
• 空仓、早期仓和重构仓的边界不稳定，自动推断很容易把临时结构当成长期架构事实。

这个 skill 提供的是一个低 token、可验证、可校准的“项目变更方向索引与边界护栏”。它不替代 agent 的详细工程分析，也不替用户做最终架构决策；它负责在动手前给出路线、证据、强约束、风险原因和后续校准方向。

核心理念

这个项目的设计原则是：

• 少乱猜优先于更聪明地猜。证据不足时宁可 review，不要伪装成确定结论。
• profile 优先于纯启发式。真实 owner、public entry、capability 边界和 path pattern 应逐步写入 .project-change-router.yaml。
• 结构证据优先于名字相似。路径、owner、public API、依赖关系、测试绑定比语义相似更可靠。
• 早期仓库默认保守。seed / emerging 阶段不应轻易自动 extend 或 extract。
• review 不是失败。它是保护机制，表示当前不能安全自动写代码，但可以进行只读分析和人工确认。
• 路由输出是一体化契约。强约束字段必须遵守，action 和解阻建议用于辅助判断，不能替代源码分析。
• 结果必须能持续变准。人工 override、误判、profile 修正和真实案例应沉淀到 feedback 与 evaluation。

两层使用模型

PCR 的输出分为两层，使用时不要混在一起理解。

必须执行层：

• 必须尊重 allowed_write_paths、forbidden_write_paths 和 must_read_before_edit。
• 必须识别并保护已有 owner、public entry、canonical root 和依赖方向。
• 不能在已有能力可能存在时新建第二套平行实现中心。
• 出现 veto_reasons、生命周期 review、低路由置信度、provisional 边界、高风险重叠时，必须先停下做确认、只读分析或 profile 修复，再写产品代码。

参考建议层：

• action 是当前证据下的处理倾向，不是最终工程命令。
• recommended_next_steps、safe_next_steps、analysis_directions、why_not_actions 和 是解阻方向和调查提示。