behavior-enhancer-generic
Behavior discipline for coding agents: read-before-write enforcement, failure convergence, write verification with auto-rollback, and a high-risk command gate. Ships FULL plugin/hook adapters for DSH, Claude Code, Codex, and Pi, plus a host-agnostic SOFT skill with ADAPTIVE adapter guidance.
- Stars
- 4
- Language
- JavaScript
- Created
- Oct 5, 2026
- Updated
- Oct 5, 2026
Introduction
behavior-enhancer-generic
把 dsh-behavior-enhancer 的行为设计做成跨宿主双形态产品:
- 插件形态(FULL):宿主提供运行时拦截能力 → 真 enforcement(拦截/veto/写后校验回滚);
- Skill 形态(SOFT):宿主只有 Agent-facing 通道 → 行为引导(自律规则)。
同一个行为语义,不同的 enforcement 强度。不吹 FULL,不假装 SOFT 是 FULL。
哪个宿主装哪个
| 宿主 | 形态 | 装什么 | 状态(2026-10-05) |
|---|---|---|---|
| DSH | FULL | adapters/dsh/(可安装插件:原插件全部模块 + F1 读前拦截 + 两个修复) | mock-ctx 全模块测试通过,待装机实测 |
| Claude Code | FULL(8 项) | adapters/claude-code/(插件,F3b 为"并发窗口拦截"等价实现) | 引擎级测试 12/12,狗粮中 |
| Codex | FULL(8 项) | adapters/codex/(config.toml hooks 或插件形态) | 协议测试 13/13,桌面版点火实测 |
| Pi | FULL(7 项 + F9 半) | adapters/pi/(pi extension) | 协议测试 11/11,实机带电实测 |
| 其他宿主 | SOFT + ADAPTIVE | skill/SKILL.md §8 引导:Agent 首次使用时按 core/adapter-template.md 自建适配器(保守测试、保守 FULL、交付报告) | 已发布形态 |
四态激活模型
每个 feature 独立激活,状态由宿主 capability surface 决定,不是用户/Agent 偏好:
| 态 | 语义 |
|---|---|
| NATIVE | 宿主已内置该行为(仅认实测),skill 闭嘴 |
| FULL | 插件级接管(拦截/veto/写后校验回滚) |
| SOFT | 行为引导(指令/流程/决策树) |
| DISABLED | 不假装具有不存在的能力 |
不写 if DSH / elif ClaudeCode 的宿主名分支,只认 capability。完整设计见
generic-skill_plan_v1.md;feature × capability 矩阵见
core/audit.md;跨宿主共享语义(token/模式表/阈值/TTL/档位阶梯)见
core/semantics.md。
与 DSH 原插件的关系
DSH 适配器基于原插件 dsh-behavior-enhancer(独立仓库)起步并叠加 generic 增量,此后各自演进,
不做同步机制:哪边改出更好的规矩,另一边觉得值就手动抄。二选一安装,不要同时装两个
(见 adapters/dsh/README.md)。
仓库结构
behavior-enhancer-generic/
├── core/ # 行为语义定义 + capability 矩阵(四态)+ 通用适配器模板(ADAPTIVE 模式)
├── skill/ # SOFT 产物:SKILL.md + 各宿主常驻片段(claude-code / codex / pi / cursor)
├── adapters/ # FULL 产物:claude-code / codex / pi(DSH 只放指针,指回原仓库)
└── README # 本文档:哪个宿主用哪一态、装哪个
测试
cd adapters/claude-code && claude plugin validate . && claude plugin test . # 12 个引擎级测试
cd adapters/codex && node test/adapter.test.cjs # 13 个协议级测试
cd adapters/pi && node test/adapter.test.cjs # 11 个协议级测试
License
MIT — 见 LICENSE。规则以 DSH 版为起点,此后独立演进。