tweakcc 补丁编写与注册指南
为 tweakcc（Claude Code 定制工具）编写并注册新补丁的完整开发手册，让开发者能安全地修改 Claude Code 的压缩源码。
该技能是面向 tweakcc 贡献者的开发文档，本身不执行代码、不请求权限；生成的补丁通过 showDiff 展示变更、失败返回 null，具备一定透明度。但补丁本质是修改 Claude Code 可执行文件（cli.js/原生二进制），且仓库层面存在绕过权限检查、抑制安装器警告等高风险示例能力；技能未涉及用户确认与回滚指引，扣分。
文档内部自洽，给出失败处理模式（模式不匹配返回 null 并输出错误）、注册清单和测试步骤，主路径可信。但均为静态说明，未执行验证；对多版本 CC 模式漂移仅提示'尝试多个模式'，边界与失败反馈较薄，静态上限内扣分。
触发条件清晰（'为 tweakcc 添加新自定义补丁时使用'），受众明确（tweakcc 贡献者），非适用范围隐含（仅限 tweakcc 内部开发，非最终用户自定义）。但对 Claude Code 版本依赖强，模式会随版本失效；无中文支持考量；对不熟悉压缩代码正则的用户门槛未披露，扣分。
结构良好：概述、分步指南、关键文件表、注册清单、补丁分组、模式编写技巧、示例、测试步骤，渐进披露合理。仓库有 MIT 许可、语义化版本（4.3.3）、CI 与测试。但技能自身无版本/变更记录，维护责任仅可从仓库推断，扣分。
能引导开发者按统一模板完成补丁创建与注册，附带性能优化与正确性技巧（[$\w]+、边界字符），边际价值明确。但输出为代码片段需开发者自行适配真实压缩代码模式，实际可用性依赖外部 CC 版本，静态审阅无法验证代表性产出，扣分。
示例代码与仓库结构（src/patches、types.ts、defaultSettings.ts、index.ts）一致，可交叉核对；仓库含 vitest 测试与 CI。但测试未覆盖技能所述关键路径（补丁编写流程本身），无第三方执行证据，静态上限内扣分。
- 该技能指导生成的补丁会直接修改 Claude Code 可执行文件，应用前务必审查 showDiff 输出并确认已存在备份（先运行 tweakcc --apply 以创建备份）。
- 正则模式与特定 CC 版本强耦合，CC 升级后补丁可能静默失效，需按版本重新验证。
- 仓库生态包含绕过权限检查等高危补丁示例，使用者应自行评估合规与安全后果。
- 未经执行验证，本评分仅为静态源码审阅结论。
这个 Skill 能做什么，适合哪些场景？
这是仓库 Piebald-AI/tweakcc 内置的 patch-creation 技能，本质是一份面向贡献者的补丁开发指南。它讲解如何通过正则表达式在 Claude Code 的压缩 cli.js（或原生二进制内嵌的 JS）中定位并替换代码，以及如何把新补丁登记进 tweakcc 的配置类型、默认设置、补丁注册表和可选 UI。文中包含完整的代码模板、注册清单、高性能正则编写技巧和测试流程。适合想为 tweakcc 添加新定制能力的开发者，而非最终用户。
指导开发者完成五步流程：在 src/patches/ 下创建补丁文件（用正则匹配压缩代码并做字符串替换，失败时返回 null，调试时调用 showDiff）；在 src/types.ts 和 src/defaultSettings.ts 中为可配置项添加类型与默认值；在 src/patches/index.ts 的 PATCH_DEFINITIONS 和 patchImplementations 中注册补丁；可选地在 MiscView.tsx 添加 UI 控件；最后用 npm run build 编译并用 npx tweakcc --apply 应用验证。
- 想为 tweakcc 贡献新功能补丁（如解锁特性、修改 UI 行为）的开源贡献者
- Claude Code 新版本发布后需要适配旧补丁正则、处理多版本差异的维护者
- 想用自己的可配置定制项扩展 tweakcc 设置系统的开发者
- 需要为补丁添加开关或输入框等 UI 控件的界面贡献者
- 想理解 tweakcc 补丁机制（ALWAYS_APPLIED / MISC_CONFIGURABLE / FEATURES 三类分组）再决定 adhoc-patch 还是正式补丁的用户
这个 Skill 有哪些优点和局限？
- 提供完整可复制的代码模板和逐步注册清单，上手路径清晰
- 包含实用的性能与正确性技巧：用 [$\w]+ 匹配标识符（$ 在压缩代码中合法）、以边界字符开头可将匹配从 1.5s 降到 30ms
- 明确要求 showDiff 调试和失败返回 null，补丁行为可观察、可回退
- 对 Claude Code 多版本差异（正则可能变化）给出了应对建议
- 仅覆盖 tweakcc 内部补丁开发，不涉及仓库 4.0.0 提供的 adhoc-patch / API 路线（需自行查阅 README）
- 技巧偏经验性（如数括号找函数体结尾），缺乏自动化工具支持
- 源文件未提供自动化测试方案，验证依赖手动运行 Claude Code 观察
- 是贡献者文档而非面向终端用户的功能说明，普通用户无需此技能
如何安装这个 Skill？
此技能随 tweakcc 仓库分发，位于 .claude/skills/patch-creation/SKILL.md。克隆仓库即可使用：git clone https://github.com/Piebald-AI/tweakcc.git && cd tweakcc。源文件未说明独立的安装命令。
如何使用这个 Skill？
按 SKILL.md 的步骤操作：1) 创建 src/patches/myPatch.ts，用形如 /,somePattern([$\w]+)/ 的正则定位压缩代码并替换；2) 需要配置项时更新 src/types.ts 与 src/defaultSettings.ts；3) 在 src/patches/index.ts 中导入函数、添加 PATCH_DEFINITIONS 条目和 patchImplementations 实现；4) 运行 npm run build 编译，npx tweakcc --apply 应用，运行 Claude Code 验证行为。
这个 Skill 与同类方案有什么区别？
仓库本身提供两条替代路线：不需要 fork 或提 PR 时，可用 tweakcc adhoc-patch 以字符串/正则/沙箱脚本三种方式打一次性补丁；或通过 npm i tweakcc 的 API 以编程方式打补丁。此技能对应的是第三条路线——把补丁正式写进 tweakcc 代码库。