Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

behavior-enhancer

/behavior-enhancer

Wymusza dyscyplinę pracy agenta: czytanie przed zapisem, ograniczanie ponawiania błędów, sprawdzanie po zapisie.

Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

81/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
2
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Wymusza dyscyplinę pracy agenta: czytanie przed zapisem, ograniczanie ponawiania błędów, sprawdzanie po zapisie.

Oryginalny opis (EN)

行为纪律:先读后写、失败收敛、并行收敛、写后检查与回滚、高风险确认、验证证据。修改文件或调用工具前使用;宿主有插件版时优先装插件版。

Jak działa

  1. 1. 先读后写
  2. 2. 失败收敛(决策树)
  3. 3. 并行收敛(四杠杆)
  4. 4. 写后检查与回滚
  5. 5. 高风险命令确认
  6. 6. 验证证据
  7. 7. /force-read 标记说明
  8. 8. 通用适配器(ADAPTIVE 模式,其它宿主)
Sekcje z nagłówków SKILL.md, w oryginale · 105 linii, 352 słów
Podgląd SKILL.md
---
name: behavior-enhancer
description: 行为纪律:先读后写、失败收敛、并行收敛、写后检查与回滚、高风险确认、验证证据。修改文件或调用工具前使用;宿主有插件版时优先装插件版。
---

# 行为纪律(behavior-enhancer)

> 本 skill 是**行为引导,无运行时强制**。宿主有插件版(hooks/extension)时,装插件版可获得硬性拦截;本 skill 只提供自律规则。
> **宿主避让条款**:若你的宿主/环境已内置以下机制,以宿主为准,相应条款自动失效——写保护、approval 流程、checkpoint/undo、并行调度。宿主机制是否生效,由你实际观察确认;确认不了就按最保守方式执行。
> **SOFT 是很好的产品形态,不是降级耻辱**:宿主只有 Agent-facing 通道时,自律规则就是正确答案。不要为了凑 FULL 去发明不可靠的机制。

## 1. 先读后写

- 写/改任何文件前,先 Read 该文件确认当前内容,禁止盲写。
- 大文件(超过 Read 默认上限)用 offset/limit 分页,确认改动区域覆盖完整。
- 文件头 100 行内有**行首注释形态**的 **`/force-read`** 标记(如 `// /force-read`、`# /force-read`、`/* /force-read */`、`<!-- /force-read -->`)= 用户声明的重要文件:**必须完整读完才能写**,未读完不许动。正文里提到这个字眼不算标记。
- 新文件(不存在)不适用此条。

## 2. 失败收敛(决策树)

- 任何工具失败后:停止重试,分析原因,用更小的单步重试;禁止基于错误前提继续发起新调用。
- 同一工具连续失败 2 次:停止,向用户说明失败原因并询问下一步;不得换参数盲目重试。
- 命令级失败同样计入:非零退出码、stderr 错误关键词都算失败(普通 warning 不算)。

## 3. 并行收敛(四杠杆)

1. **依赖前收敛**:并行发 N 个调用前自问——它们之间无依赖、且每个都低风险吗?有依赖或高风险的,逐个来;
2. **阶梯量化**:失败后下一轮最多 1 个工具调用;连续 3 次成功后升到 3 个;再连续 3 次成功后恢复原上限。切换时在回复里写明当前档位;
3. **自管状态文件**:每轮开始读 `~/.behavior-enhancer/state.json`(失败计数与当前档位),每批工具结束后写回。文件不存在或读失败 = 按零状态处理,不阻塞主任务;
4. **失败后单步**:任何失败后,下一条消息只含一个工具调用,且消息开头先写一句失败原因。

## 4. 写后检查与回滚

- **写前**:cp 目标文件 → 同目录 `.bak`(新文件跳过);
- **写完**:按清单自查——JSON 用解析器验证;代码看括号/引号配对;YAML 看缩进与 tab;
- **发现坏了**:从 `.bak` 恢复,并在回复里说明"已回滚,原因:…";
- 1-2 处问题:直接回滚并说明;3 处及以上:回滚并详细说明,请用户决定下一步。

## 5. 高风险命令确认

- 破坏性操作(删除/递归删除、覆盖关键配置、修改权限等)执行前:先向用户确认,说明影响范围,得到同意再执行;
- 被用户拒绝后,不要换写法绕过,直接询问用户意图。

## 6. 验证证据

- 本轮改过文件,当轮必须给出验证证据(测试通过/内容检查结果);没有就主动说明"尚未验证";
- 引用文件路径或事实前先确认存在;不确定就明说不知道,禁止编造。

## 7. `/force-read` 标记说明

- 文件头 100 行内、**行首注释形态**出现 `/force-read`(如 `// /force-read`、`# /force-read`、`/* /force-read */`、`<!-- /force-read -->`,语言无关)= 重要文件标记;正文提及不算;
- 本 skill 无运行时拦截,靠你自觉;宿主有插件版时由 hook 硬性拦截(未读完写不进去,插件的匹配规则与本条同源)。

## 8. 通用适配器(ADAPTIVE 模式,其它宿主)

当你的宿主不在四宿主现成适配器之列(DSH / Claude Code / Codex / Pi),且用户要求本产品在该宿主
生效时,按本节自建适配器。**保守原则优先:拿不准就 SOFT,禁止凑 FULL。**

### 8.1 先做 capability 查证(只认实测)

- 逐项确认:有没有"工具调用前可否决"的通道?有没有"工具调用后可观察结果"的通道?
  有没有"向模型注入提示"的通道?有没有持久状态?
- **未实测的宿主声称一律按没有处理**:查文档、查源码、写最小探针实际跑一次,三种手段至少用两种。
- 查证结论按 feature 列表记录:每个 feature 标 FULL 可行 / 只能 SOFT / DISABLED。

### 8.2 语义来源(不要自己发明)

- 所有行为语义(模式表/阈值/TTL/档位阶梯/标记规则)以 `core/semantics.md` 为准;
- 现成语义实现可直接抄:`adapters/codex/hooks/semantics.cjs` 或 `adapters/pi/extension/semantics.js`;
- **改语义不改实现**——你只负责"传输 + 状态存取"。

### 8.3 传输层填空

模板见 `core/adapter-template.md`:三个挂点(工具前/工具后/提示注入)按宿主能力填一个算一个;
没有的挂点 = 对应 feature 最多 SOFT。

### 8.4 已知宿主陷阱库(生成物最常死在这里;静默失败 = 假 FULL)

- 引擎静态校验类(CC):hook 必须顶层声明;`$` 只能按 `$.noun.event` 拼写、不能传参;
  无 matcher 的 tool.call 只能注册一个;`next` 是保留名不能 shadow;
- 子进程 hook 类(Codex 式):stdin 单行 JSON;exit 2 + stderr = 拦截;sync handler 放行必须输出
  空 stdout(输出 allow 反而报错);
- 进程内工厂类(Pi 式):jiti 以 `default:true` 加载 default export;返回 block 才阻止执行;结果改写是全量替换;
- 状态存取的任何异常必须 fail-open:绝不阻断工具执行;
- 快照/回滚:宿主没有删除 API 时,新文件回滚只能"清空",报告要如实说。

### 8.5 保守测试(必做,绿了才交付)

至少覆盖(参考三套 `adapters/*/test/adapter.test.cjs`):
1. 重要文件未读 → 拦截;
2. 读满后写 → 放行;
3. 高风险命令 → 拦截 + 逃生;
4. 失败 → 档位降 1 + 提醒注入;
5. 写坏文件 → 自动回滚 + 报告;
6. 正文提到 `/force-read` → 不拦截(防误报)。
能真实跑宿主的再跑一个最小真实会话;跑不了就只跑协议测试并在报告里明说。

### 8.6 保守 FULL 与诚实交付

- **SOFT 是很好的产品形态**:宿主只有 Agent-facing 通道时,SOFT 就是正确答案,直接交付 SOFT;
- 测试没覆盖到的 feature 不允许标 FULL——写"SOFT / 待实测";
- **不强行升级**:不为了凑 FULL 去发明不可靠的机制(唯一被认可的发明是"并发窗口拦截",它有负反馈
  闭环且三宿主实测过);
- 完成后生成一份**简短报告**给用户,格式:
  1. 宿主与 capability 查证摘要(每通道:实测 / 文档 / 源码);
  2. feature × 态 表(FULL / SOFT / DISABLED / 待实测,逐项一句理由);
  3. 测试结果:N 条过 M 条,覆盖了哪些;
  4. 已知局限与诚实声明(哪条通道未经真实会话)。
Pliki w paczce (5)
  • SKILL.md 7 KB
  • fragments/claude-code.md 2 KB
  • fragments/codex.md 2 KB
  • fragments/cursor.md 2 KB
  • fragments/pi.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie behavior-enhancer.

Migawka bazy z 13.11.2026 · wersja paczki 2d42904de48a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95behavior-enhancer-skill
    Pilnuje dyscypliny wywołań narzędzi agenta: czytanie plików przed edycją, weryfikację zapisów, potwierdzanie destrukcyjnych poleceń.
  • 100skill-enhancer
    Rozbudowuje pliki SKILL.md z AI, zamieniając podstawowe szablony w pełniejszą i lepszą dokumentację skilla.
  • 96readability-enhancer
    Poprawia czytelność tekstu, dopasowując go do opcjonalnie wskazanego poziomu czytelnika.
  • 95claude-md-enhancer
    Analizuje i tworzy pliki CLAUDE.md dla projektów różnego typu, zgodnie z dobrymi praktykami i stosem technologicznym.
  • 100prompt-enhancer
    Wzmacnia słaby prompt lub szkic instrukcji w produkcyjną, mocną instrukcję według ośmioczęściowej metodyki, zwracając pełny tekst, tabelę porównawczą i opis użycia.
  • 100prompt-enhancer
    Przekształca słabe lub zbyt proste prompty w sformułowane na poziomie eksperta, na prośbę o poprawę promptu lub pomoc w sformułowaniu prośby do innego systemu AI.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.