scope-guard
评分功能价值，限制分支大小防过度工程
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：scope-guard。 它的用途是：评分功能价值，限制分支大小防过度工程 完整的 Skill 内容见：https://321skill.com/skills/scope-guard-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用 scope-guard 评估当前 PR 的功能价值并检查分支大小是否超标'，它会自动扫描代码变更，量化功能价值分数（如 72 分，大于阈值 60），并提示分支总变更行数为 480 行（未超过限制 500 行），给出通过建议。如果分数低于阈值或行数超标，会给出具体警告和修改建议。
介绍
在软件开发中，过度工程化（overengineering）是导致代码膨胀、维护成本上升的常见问题。scope-guard 通过引入功能价值评分机制，自动评估每次代码变更的“值得做”程度，并强制限制分支大小，帮助团队在开发早期就识别并抑制不必要的复杂设计，从而保持代码库的简洁和可维护性。
使用方式非常简单：将 scope-guard 集成到你的 CI/CD 流程中（如 Git 钩子、GitHub Actions 或 Jenkins 流水线），在创建 PR 或合并请求时自动运行。它会扫描当前分支的代码变更，基于变更的复杂度、影响范围、文件数量、功能重要性等多维度指标计算出功能价值分数，并与预设阈值比较；同时检查分支总变更行数是否超过限制，若超过则给出警告或直接阻止合并。
scope-guard 特别适合后端开发、全栈开发以及技术负责人，尤其是那些维护大型代码库、需要严格控制代码质量的中大型团队。项目经理也可以利用其评分结果来决策是否值得投入精力实施某个功能。对于个人开发者，在独立项目中使用也能有效避免“过度设计”陷阱，保持代码聚焦。
建议在团队内统一配置评分阈值和分支大小限制，避免因个人标准差异导致误判。同时，scope-guard 应作为辅助工具，最终决策仍需结合人工评审。对于临时性的实验性分支或大型重构任务，可以暂时跳过检查，但推荐在正式合并前重新启用。
核心特点
与常见的分支大小限制工具（如 git-lint）不同，scope-guard 创新地引入了功能价值评分机制，能量化评估“这个功能是否值得做”，从源头防止过度工程化，而不仅仅是限制代码行数。
注意事项
不适合需要频繁变更且分支大小自然偏大的项目（如大规模重构、跨模块依赖升级），此时可能需要手动调整阈值或跳过检查。
常见问题
scope-guard 如何计算功能价值分数？
基于代码变更的复杂度（如文件数量、修改行数、引入的新依赖）、影响范围（如涉及的核心模块数量）、功能重要性（由配置文件中的权重或历史数据决定）等指标，通过加权模型输出 0-100 的分数。
分支大小限制可以自定义吗？
可以。在项目根目录添加 .scope-guard.yml 配置文件，设置 max_branch_size（默认 500 行）和 score_threshold（默认 60 分）等参数。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/scope-guard-x-7/raw/index.md 读取 scope-guard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/scope-guard-x-7/raw/index.md（查看排版版本）