mcpField
C
code-simplification

code-simplification

github.com/carlitose开发043 次安装2 周前更新
代码仓库

关于 code-simplification

用于精简近期改动代码的 Skill,强调保持行为和项目约束不变。它适用于提供差异、语义不变量、允许路径及当前通过检查的代码变更流程。

主要功能

  1. 01限制输入与输出字节数
  2. 02识别具体的局部精简机会
  3. 03保持行为和项目约束
  4. 04编辑后运行针对性检查
  5. 05报告改动与剩余限制

适用场景

  1. 01精简近期改动中的重复代码
  2. 02减少不必要的间接层或分支
  3. 03所需输入超出字节限制时停止

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/carlitose/agent-skills --skill code-simplification

安装后在 Claude Code 中输入/code-simplification确认已加载。

附带文件agents/openai.yaml

详细介绍

代码简化

职责:专注于简化近期修改的代码。不选择工单、不扩大范围、不审查验收情况、不生成 QA/审计材料、不提交、不推送、不创建 PR,也不最终确定工作流状态。

输入

需要提供变更差异、允许修改的路径、语义不变量、项目约定以及当前通过的检查。如果候选项不是 GREEN,则不做编辑并直接返回。

易变输入上限

  • max_volatile_bytes:每次调用最多 103232 个规范化 UTF-8 字节。该值由观测到的 96,393 字节候选差异峰值,加上 2,380 字节工单正文和 4,459 字节实现交接内容的最大值组成。语料包括本次运行的 TK-01/TK-02/TK-05/TK-07/TK-08 规范化 git diff --no-ext-diff --no-color 观测结果、九份工单正文以及精简的叶节点结果。
  • max_single_output_bytes:32596,即观测到的 TK-02 可执行代码候选差异。

对每份差异、文件片段、粘贴的交接内容、证据正文和工具结果,都要在将 CRLF 或单独的 CR 规范化为 LF 后计数。先读取清单;命令输出在进入上下文前就要截断,较大的差异应按文件或代码块切分。优先使用路径加 SHA-256 引用,而不是粘贴材料;仅当确实需要材料内容时才计入。如果下一次必需读取会超出任一上限,就在读取或编辑前停止,并返回剩余引用的确切内容及 budget-exhausted;后续调用可继续。此上限绝不允许省略保留义务,也不允许在缺少证据时声称等价。

契约

保留:

  • 外部可观察行为和公共契约;
  • 错误、验证顺序、副作用、重试和持久化语义;
  • 安全与数据完整性边界;
  • 工单范围和用户无关的变更;
  • 测试和项目约定。

流程

  1. 在上下文中阅读变更后的代码,并找出具体的重复、不必要的间接层、令人困惑的命名或本地可避免的分支。
  2. 优先采用能清晰表达意图的最小改动。不要引入推测性的抽象、大范围格式调整、兼容性垫片或架构重写。
  3. 每完成一项连贯的编辑,就运行范围最窄的相关检查。如果无法证明行为等价,则撤销这项简化。
  4. 返回变更路径、所做的简化、观测到的检查结果以及尚存的限制。

没有观测到证据时,绝不声称等价或检查通过。任何编辑都会创建新的 CandidateRef,并使调用方持有的先前审查/QA/审计证据失效。

评论

支持 Markdown