scope-guard
评分功能价值，强制分支大小，防止过度工程化
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：scope-guard。 它的用途是：评分功能价值，强制分支大小，防止过度工程化 完整的 Skill 内容见：https://321skill.com/skills/scope-guard-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我用 scope-guard 检查当前 feature-x 分支，评估新功能的价值并检查分支大小是否超过1000行。' 它会自动对比主分支，扫描变更内容，生成评分报告并提示是否合规。
介绍
scope-guard 是一个专注于防止过度工程化的 AI 辅助工具。它通过自动评估每个新功能或代码变更的“功能价值”得分，并强制限制分支（branch）的代码行数或文件数量，帮助开发团队在保持代码质量的同时，避免陷入不必要的复杂化和冗余设计。
使用方式非常简单：在 Pull Request 创建或代码提交前，配置 scope-guard 的规则（如分支大小上限、功能价值评分阈值），它会自动扫描当前分支的变更内容，生成一份包含“功能必要性评分”和“分支规模合规性”的报告。如果某个变更的评分过低或分支过大，工具会给出警告甚至阻止合并，引导开发者重新审视设计。
适合所有使用 Git 分支工作流的开发团队，尤其是中大型项目或对代码可维护性要求较高的场景。全栈开发者、后端开发者以及智能体开发者（如构建复杂 Agent 系统时）都能从中受益，因为它能有效减少“为了扩展而扩展”的冗余代码。
使用建议：建议将 scope-guard 集成到 CI/CD 流程中，作为代码审查的前置环节。注意不要将阈值设置得过于严格，避免影响正常的快速迭代。对于短期实验性分支或原型开发，可以临时跳过检查。
核心特点
其他代码审查工具主要检查代码风格、安全漏洞或单元测试覆盖率，而 scope-guard 直接评估每个功能变更的“必要性”并限制分支规模，从源头抑制过度工程化，而非事后修复。
注意事项
不适合纯文档修改、配置变更或紧急修复等不需要评估功能价值的场景。
常见问题
功能价值评分是怎么计算的？
根据变更涉及的文件数量、新增代码行、与核心功能的相关度、以及是否引入了新的依赖等维度综合打分，具体算法可自定义配置。
分支大小限制可以灵活调整吗？
可以。在配置文件中设置 max_lines 或 max_files 参数，支持按项目或分支前缀设置不同阈值。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/scope-guard-x-5/raw/index.md 读取 scope-guard 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/scope-guard-x-5/raw/index.md（查看排版版本）