scope-guard
评估功能价值并限制分支规模，防止过度工程
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：scope-guard。 它的用途是：评估功能价值并限制分支规模，防止过度工程 完整的 Skill 内容见：https://321skill.com/skills/scope-guard-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请用 scope-guard 检查当前 feature/login 分支的改动。’，它会分析该分支的代码变更，计算其“价值分数”并对比预设的分支大小限制，然后给出评估报告，例如“此分支新增 800 行代码，超过 500 行限制，建议拆分为更小的 PR 或说明其高价值理由”。
介绍
Scope Guard 主要解决软件开发中常见的“过度工程”问题。开发者在实现新功能或修复 Bug 时，容易陷入追求完美、添加不必要复杂性的陷阱，导致代码臃肿、维护成本增加，甚至偏离核心需求。
该技能通过量化评估“功能价值”和强制执行“分支规模限制”来工作。它可能基于代码变更量、复杂度、依赖引入情况等指标，对当前开发分支的修改进行评分，判断其是否“物有所值”。当分支规模（如代码行数、文件改动数）超过预设阈值时，它会发出警告或阻止合并，促使开发者将大改动拆分为更小、更聚焦的迭代。
它非常适合追求代码质量与开发效率平衡的工程师，特别是全栈开发、后端开发和运维开发人员。在敏捷团队、需要严格代码审查或项目初期容易陷入设计膨胀的场景中，它能成为一道有效的“刹车”机制。
使用建议是将其集成到 CI/CD 流程中，作为代码合并前的自动化检查环节。注意事项包括，阈值需要根据项目实际情况（如项目阶段、团队规模）进行合理配置，避免过于严格阻碍正常开发或过于宽松形同虚设。它应作为辅助决策工具，而非完全取代人工代码评审。
核心特点
与一般代码质量检查工具（如检查代码风格、复杂度）不同，Scope Guard 的核心区别在于其“价值导向”和“规模管控”的双重机制。它不仅检查代码“怎么写”，更评估代码“为什么写”以及“写了多少”，直接针对“过度工程”这一具体痛点进行干预，而不仅仅是事后静态分析。
注意事项
不适合用于评估原型验证、探索性研究或算法实验等需要快速试错、变更范围难以预先界定的小型独立项目。
常见问题
Scope Guard 如何判断一个功能是否“值得”？
它通常结合代码变更的规模、复杂度、引入的新依赖以及预设的业务价值权重模型进行综合评分，具体算法取决于实现。
分支大小限制应该设置为多少？
没有固定值，建议根据团队习惯和项目类型（如微服务、单体应用）设定初始值（如 500 行），再根据实际合并频率和评审负担动态调整。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/scope-guard-x-2/raw/index.md 读取 scope-guard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/scope-guard-x-2/raw/index.md（查看排版版本）