关于 code-simplification
用于精简近期改动代码的 Skill,强调保持行为和项目约束不变。它适用于提供差异、语义不变量、允许路径及当前通过检查的代码变更流程。
主要功能
- 01限制输入与输出字节数
- 02识别具体的局部精简机会
- 03保持行为和项目约束
- 04编辑后运行针对性检查
- 05报告改动与剩余限制
适用场景
- 01精简近期改动中的重复代码
- 02减少不必要的间接层或分支
- 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;后续调用可继续。此上限绝不允许省略保留义务,也不允许在缺少证据时声称等价。
契约
保留:
- 外部可观察行为和公共契约;
- 错误、验证顺序、副作用、重试和持久化语义;
- 安全与数据完整性边界;
- 工单范围和用户无关的变更;
- 测试和项目约定。
流程
- 在上下文中阅读变更后的代码,并找出具体的重复、不必要的间接层、令人困惑的命名或本地可避免的分支。
- 优先采用能清晰表达意图的最小改动。不要引入推测性的抽象、大范围格式调整、兼容性垫片或架构重写。
- 每完成一项连贯的编辑,就运行范围最窄的相关检查。如果无法证明行为等价,则撤销这项简化。
- 返回变更路径、所做的简化、观测到的检查结果以及尚存的限制。
没有观测到证据时,绝不声称等价或检查通过。任何编辑都会创建新的 CandidateRef,并使调用方持有的先前审查/QA/审计证据失效。
评论
支持 Markdown