К основному содержанию
скилл CX Codex

patch-creation — скилл для Claude Code: что делает и как установить

Скилл patch-creation помогает создавать и регистрировать патчи для утилиты tweakcc, модифицирующей сборку Claude Code. Пригодится при добавлении кастомных настроек и твиков.

MIT ★ 2 619 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Piebald-AI/tweakcc --skill patch-creation -a claude-code
Открыть на GitHub

Что делает patch-creation

Скилл даёт инструкции и примеры для модификации минифицированного файла cli.js или бинарника Claude Code. Он описывает структуру отдельного патча в каталоге src/patches/*.ts, подстановку фрагментов кода по регулярным выражениям и протоколирование изменений через showDiff().

Поиск по минифицированному JavaScript требует точных правил. В регулярных выражениях для названий переменных обязательно используется шаблон [$\w]+, поскольку символ $ допустим в идентификаторах. Шаблоны рекомендуется начинать с граничных символов вроде запятой или точки с запятой: это сокращает время поиска с 1.5s до 30ms. Инструкция также задаёт порядок регистрации изменений в src/patches/index.ts, типы в src/types.ts и начальные параметры в src/defaultSettings.ts.

Без предварительной компиляции через npm run build и применения изменений командой npx tweakcc --apply проверить работу патча в Claude Code не выйдет.

Какие задачи решает

  • написать регулярное выражение для поиска фрагментов в минифицированном cli.js
  • зарегистрировать новый патч в файле src/patches/index.ts
  • добавить типы настроек в src/types.ts и src/defaultSettings.ts
  • создать переключатель для твика в src/ui/components/MiscView.tsx

Примеры запросов агенту

  • Создай новый патч для tweakcc, отключающий проверку фичефлага в Claude Code
  • Зарегистрируй патч my-patch в группе FEATURES и добавь его параметры в types.ts
  • Помоги написать регулярное выражение с граничными символами для cli.js

Как установить patch-creation

1Через Skills CLI (Vercel)

npx skills add Piebald-AI/tweakcc --skill patch-creation -a claude-code

2Вручную: положить файлы

~/.claude/skills/patch-creation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/patch-creation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о patch-creation

Как установить patch-creation в Claude Code?

Выполните команду npx skills add Piebald-AI/tweakcc --skill patch-creation -a claude-code.

Что делает скилл patch-creation?

Он направляет процесс создания, тестирования и регистрации патчей для tweakcc, которые внедряют изменения в бинарник или скрипт Claude Code.

Зачем в шаблонах regex использовать [$\w]+ вместо обычного \w+?

В минифицированном коде JavaScript знак $ часто встречается в именах переменных. Стандартный класс \w+ или границы слов \b не считают знак доллара частью слова и пропускают совпадения.

Исходный текст

SKILL.md · MIT
---
name: patch-creation
description: Create and register new patches for tweakcc. Use when adding new customizations to Claude Code.
---

# Patch Creation & Registration

## Overview

Patches are code modifications applied to Claude Code's `cli.js` (or native binary). Each patch finds specific patterns in the minified code and replaces/injects new behavior.

## Creating a New Patch

### 1. Create the patch file

Create `src/patches/myPatch.ts`:

````typescript
// Please see the note about writing patches in ./index

import { showDiff } from './index';

/**
 * Description of what this patch does.
 *
 * CC X.Y.Z:
 * ```diff
 *  // Show before/after of the code change
 * -oldCode
 * +newCode
 * ```
 */
export const writeMyPatch = (
  file: string,
  configValue: string // Add parameters as needed
): string | null => {
  // Pattern to find in minified code
  // IMPORTANT: Use [$\w]+ for identifiers (not \w+) because $ is valid in JS identifiers
  // IMPORTANT: Start patterns with a boundary char (,;}{) for HIGH performance (e.g. 1.5s -> 30ms)
  const pattern = /,somePattern([$\w]+)/;

  const match = file.match(pattern);

  if (!match || match.index === undefined) {
    console.error('patch: myPatch: failed to find pattern');
    return null;
  }

  const replacement = `,newCode${match[1]}`;

  const startIndex = match.index;
  const endIndex = startIndex + match[0].length;

  const newFile =
    file.slice(0, startIndex) + replacement + file.slice(endIndex);

  showDiff(file, newFile, replacement, startIndex, endIndex);

  return newFile;
};
````

### 2. Add config type (if patch is configurable)

Edit `src/types.ts` - add to `MiscConfig` or create a new interface:

```typescript
export interface MiscConfig {
  // ... existing fields ...
  myNewSetting: string | null; // null = disabled
}
```

### 3. Add default value

Edit `src/defaultSettings.ts`:

```typescript
misc: {
  // ... existing fields ...
  myNewSetting: null,  // or a sensible default
},
```

### 4. Register in index.ts

Edit `src/patches/index.ts`:

**4a. Add import:**

```typescript
import { writeMyPatch } from './myPatch';
```

**4b. Add patch definition (in `PATCH_DEFINITIONS` array):**

```typescript
{
  id: 'my-patch',
  name: 'My patch',
  group: PatchGroup.FEATURES,  // or ALWAYS_APPLIED, MISC_CONFIGURABLE
  description: 'What this patch does for the user',
},
```

**4c. Add patch implementation (in `patchImplementations` object):**

```typescript
'my-patch': {
  fn: c => writeMyPatch(c, config.settings.misc!.myNewSetting!),
  condition: !!config.settings.misc?.myNewSetting,
},
```

### 5. Add UI (optional)

Edit `src/ui/components/MiscView.tsx` to add a toggle or input for the setting.

## Key Files

| File                             | Purpose                                            |
| -------------------------------- | -------------------------------------------------- |
| `src/patches/*.ts`               | Individual patch implementations                   |
| `src/patches/index.ts`           | Patch registry, definitions, and application logic |
| `src/types.ts`                   | Config type definitions (`MiscConfig`, etc.)       |
| `src/defaultSettings.ts`         | Default values for all settings                    |
| `src/ui/components/MiscView.tsx` | UI for misc settings                               |

## Registration Checklist

When adding a new patch, update these locations:

- [ ] `src/patches/myPatch.ts` - Create the patch file with exported function
- [ ] `src/types.ts` - Add config type (if configurable)
- [ ] `src/defaultSettings.ts` - Add default value (if configurable)
- [ ] `src/patches/index.ts`:
  - [ ] Import the patch function
  - [ ] Add to `PATCH_DEFINITIONS` array (id, name, group, description)
  - [ ] Add to `patchImplementations` object (fn, condition)
- [ ] `src/ui/components/MiscView.tsx` - Add UI controls (optional)

## Patch Groups

- `PatchGroup.ALWAYS_APPLIED` - Core patches that are always applied
- `PatchGroup.MISC_CONFIGURABLE` - User-configurable misc settings
- `PatchGroup.FEATURES` - Feature patches that can be enabled/disabled

## Pattern Writing Tips

1. **Use `[$\w]+` for identifiers** - Not `\w+`, because `$` is valid in JS identifiers and common in minified code

2. **Start patterns with boundary characters** - Use `,`, `;`, `{`, `}` at the start to dramatically speed up matching (can reduce 1.5s to 30ms)

3. **Don't use `\b` for word boundaries** - It doesn't treat `$` as a word character, so `\b[$\w]+` won't match `,$=`

4. **Extract function bodies carefully** - Count braces to find matching `}` when you need the full function

5. **Use `showDiff()` for debugging** - Always call it to log what the patch is changing

6. **Return `null` on failure** - Let the patch system know the patch couldn't be applied

7. **Handle multiple CC versions** - Code patterns may change between versions; try multiple patterns if needed

## Example: Simple Toggle Patch

```typescript
// Bypass a feature flag check
const pattern = /function [$\w]+\(\)\{return [$\w]+\("my_feature_flag"/;
const match = file.match(pattern);

if (!match || match.index === undefined) {
  console.error('patch: myPatch: failed to find feature flag');
  return null;
}

const insertIndex = match.index + match[0].indexOf('{') + 1;
const insertion = 'return true;';

const newFile =
  file.slice(0, insertIndex) + insertion + file.slice(insertIndex);

showDiff(file, newFile, insertion, insertIndex, insertIndex);
return newFile;
```

## Example: Replace a Value

```typescript
// Replace a hardcoded value
const pattern = /(someConfig=)\d+(;)/;
const match = file.match(pattern);

if (!match || match.index === undefined) {
  console.error('patch: myPatch: failed to find config value');
  return null;
}

const replacement = match[1] + newValue + match[2];
const startIndex = match.index;
const endIndex = startIndex + match[0].length;

const newFile = file.slice(0, startIndex) + replacement + file.slice(endIndex);

showDiff(file, newFile, replacement, startIndex, endIndex);
return newFile;
```

## Testing

1. Run `npm run build` to compile
2. Run `npx tweakcc --apply` to apply patches
3. Check console output for patch success/failure
4. Run Claude Code to verify behavior

© Piebald-AI · MIT · Piebald-AI/tweakcc

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
mantis-patch официальный google Скилл mantis-patch создаёт минимальные исправления безопасности в изолированном окружении, накладывает патчи и проверяет результат на воспроизведённых уязвимостях. CX Codex +1 1 600установок implement-patch trailofbits Скилл implement-patch для Claude Code организует исправление подтверждённых багов на уровне нарушенных инвариантов. Формирует регрессионный тест, единый локальный коммит и файлы патчей. CX Codex +1 677установок prove-patch trailofbits Скилл prove-patch для Claude Code проверяет локальный security patch commit независимыми тестами и трёхсторонним сравнением. Запускается для scoped proof исправления. CX Codex +1 676установок threat-patch pproenca Скилл threat-patch берёт находки сканера или модель угроз и превращает их в небольшие патчи кода с описанием правок и шагами проверки. CX Codex +1 232установок Hedera Policy Creation hedera-dev Скилл Hedera Policy Creation помогает создавать блокирующие правила валидации для Hedera Agent Kit. Пригодится при настройке лимитов сумм, списков разрешённых аккаунтов и ограничений частоты вызовов. CX Codex +1 613установок Hedera Hook Creation hedera-dev Скилл Hedera Hook Creation помогает создавать ненаблюдаемые и неизменяющие поток выполнения хуки для Hedera Agent Kit. Пригодится при настройке аудита вызовов, сборе метрик или сохранении состояния сессии. CX Codex +1 612установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой