最小修复技能（Minimal Fix）
针对明确问题生成最小代码变更，绝不顺带重构。
该技能明确要求遵守路径黑名单，禁止编辑.env、认证、支付等敏感文件，并提供了升级而非违规编辑的指引。同时它要求优先使用工作树隔离，避免未监控的修改，且强调不要自我标记完成，由验证者决定。这些措施表明对最小权限和人工确认的重视。但由于发布者身份未经认证，且未提供具体的数据流透明度或回滚机制（如只有在工作树隔离时才提及），在静态评估中缺少细粒度证据，因此扣除部分分数。
指令内容连贯一致，步骤清晰，并提供了成功路径的示例输出格式。但该技能没有内置的测试套件或自动验证机制，失败反馈机制描述不足（如当无法重现失败时如何处理），且缺乏对异常输入（如缺失文件或歧义问题）的处理说明。因此根据静态校准，得分上限为10，但实际证据不足，未能达到该上限。
该技能场景明确，输入输出清晰，触发条件描述为‘仅当修复目标明确时’，边界声明了不进行无关重构，但未定义非适用范围（如问题模糊或涉及多个文件时的处理）。环境适配性未明确评估，未提及对中文用户的支持及中国大陆网络可达性（GitHub等外部服务可能受限），因此扣分。
文档结构良好，有清晰的标题、步骤和输出模板，并包含规则部分。仓库有MIT许可证，但技能本身未提供版本号或变更日志。缺少具体的故障排查指导和更多示例，维护责任仅通过仓库层面体现。因此，在规范维度上有所扣分。
技能定义明确，预期输出为一份修复提案，包含摘要和验证结果，清晰且直接可用。但静态审核无法验证输出的实际正确性或完整性，且未提供实际使用案例或对比基准。因此，在有效性上给予中等偏低的分数。
存在CI和测试基础设施，但未直接验证此技能的关键路径。没有第三方执行证据或独立复现结论。因此，在可验证性上分数较低。
- 该技能依赖外部服务（如GitHub）和项目上下文，从中国大陆访问可能受限，需考虑网络可达性。
- 静态评估未验证技能在真实项目中的效果，建议在受控环境中先行测试。
- 发布者身份未经验证，使用前应评估其信誉。
这个 Skill 能做什么，适合哪些场景？
Minimal Fix 技能引导 AI 编码代理仅修复一个具体问题，产出最小可行的 diff。它要求输入精确的错误信息、审查评论或问题描述，并遵循路径拒绝列表（如 .env、auth/、payments/）以及项目构建/测试命令。流程包括定位根本原因、只做必要修改、运行相关测试并输出结构化摘要。该技能可从 loop-engineering 仓库安装，该仓库提供相关 CLI 工具（如 loop-init 用于搭建起始项目）。
读取失败信息、审查评论或问题描述作为输入；可选地读取目标文件路径、AGENTS.md 或项目技能中的构建/测试命令，以及循环安全策略中的路径拒绝列表。运行测试/检查命令以验证变更。生成包含目标说明、diff 摘要、验证结果和风险评估的 Markdown 报告。
- 开发者在 CI 流水线遇到失败，想要最小修复而不引发范围蔓延。
- 工程师在处理代码审查评论时，希望只解决提出的点。
- 维护者需要小团队快速修复紧急性小问题。
- 自动化循环（如 CI 清扫器）在无人监督时应用安全、范围明确的修复。
这个 Skill 有哪些优点和局限？
- 强制最小范围，防止拖泥带水的重构。
- 要求验证（运行测试/检查）。
- 产出结构化摘要，便于人类审查。
- 通过路径拒绝列表和人工门控增强安全性。
- 仅在修复目标明确时有效；表述模糊的问题需要先清理。
- 需要外部流程维护拒绝列表和构建命令。
- 无内置测试套件；正确性取决于环境。
- 在无人监督模式下，如果验证不足，仍有引起意外回归的风险。
如何安装这个 Skill？
克隆或复制仓库：git clone https://github.com/cobusgreyling/loop-engineering.git。该技能位于 skills/minimal-fix/SKILL.md。整个仓库包含多个技能和工具；要仅使用此技能，请将 skills/minimal-fix 文件夹复制到您的代理技能目录。或者，使用 loop-init 脚手架工具（npx @cobusgreyling/loop-init .）初始化技能结构，该工具会创建必要的文件结构。
如何使用这个 Skill？
以在代理环境中调用技能的方式使用它，例如通过提供输入：确切的错误消息或审查评论、相关文件路径和构建命令。例如，提示代理：'使用 Minimal Fix 技能修复此 CI 错误：...，文件 ...，构建命令 ...'。该技能将引导代理完成最小修复过程并输出结构化提案。确保存在 AGENTS.md 或项目技能包含构建命令以及路径拒绝列表（来自循环安全策略）。