WeirdSky924/project-change-router-skill

README 摘要

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 的详细工程分析，也不替用户做最终架构决策；它负责在动手前给出路线、证据、强约束、风险原因和后续校准方向。 核心理念 这个项目的设计原则是： - 少乱猜优先于更聪明地猜。证据不足时宁可保留 unknown 并让 execution gate=blocked ，不要伪装成确定结论。 - profile 优先于纯启发式。真实 owner、public entry、capability 边界和 path pattern 应逐步写入 .project-change-router.yaml 。 - 结构证据优先于名字相似。路径、owner、public API、依赖关系、测试绑定比语义相似更可靠。 - 早期仓库默认保守。 seed / emerging 阶段不应轻易自动 extend 或 extract 。 - review 不是失败，也不是写入门禁；它是 action 建议层的调查方向。真正决定当前是否可写的是 execution gate 。 - 路由输出是一体化契约。 execution gate 、安全信封和 typed findings 必须遵守， action 和解阻建议用于辅助判断，不能替代源码分析。 - 结果必须能持续变准。人工 override、误判、profile 修正和真实案例应沉淀到 feedback 与 evaluation。 两层使用模型 PCR 的输出分为两层，使用时不要混在一起理解。 必须执行层： - 必须先读 execution gate.state ： pass 、 conditional 、 blocked 是唯一权威写入状态。 - …

分类