l123-harness
L1-L2-L3 三层记忆代理框架：门控审批、无评判事件日志、每周提炼、TDD 执行循环。Claude Code 插件和 DeepSeek Harness (dsh) 捆绑包。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:reatcat/l123-harness#9c52bfcb9ad4334ed38c4bcbd45dd8984e9d71cbL123 Harness 以 l123-harness 发布，当前版本为 1.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把一套经过实战检验的 agent 方法论打包成插件：Claude Code 插件 + DeepSeek Harness (dsh) 组合包，同一套内容双宿主分发。设计对齐「一切皆插件」： 宿主是内核，本插件只提供能力组件——上下文注入、门禁、事件记录、记忆提炼， 全部可单独理解、可整体装卸。项目知识不在插件里：插件装机后由项目自己积累。
English — l123-harness packages a battle-tested agent methodology as a plugin for both Claude Code and DeepSeek Harness (
dsh): a three-tier memory system (L1 always-onCLAUDE.md/ L2 index / L3 details) plus gate approval for protected files, a zero-judgement event log, weekly distillation, and a TDD execution loop. Install for dsh:dsh plugin --profile web add github:reatcat/l123-harness
| 层 | 载体 | 特点 |
|---|---|---|
| L1 常驻 | CLAUDE.md | 小而稳定的缓存前缀：原则、优先级、安全底线、路由表 |
| L2 索引 | .agents/INDEX.md | 症状→一句规则→L3 指针；SessionStart hook 自动注入 |
| L3 详情 | .agents/** | knowledge / pitfalls / runbooks / current / events / inbox |
l123-harness/
├── .claude-plugin/plugin.json # Claude Code 插件清单
├── package.json # dsh 组合包清单（dsh.bundle）
├── cordis.patch.yml # dsh 组合层：插入本插件行
├── dsh/index.js # dsh 入口：注册技能 + 挂载官方 hooks 桥接
├── hooks/
│ ├── hooks.json # 事件接线（6 个生命周期事件）
│ ├── on-session-start.sh # 记事件 + 注入 L2 索引
│ ├── gate-guard.sh # PreToolUse 门禁：保护清单 + 一次性审批令牌
│ ├── on-post-tool.sh # 工具报错 → tool_error 事件（热路径零解释器）
│ ├── on-pre-compact.sh # 压缩前抢救 .agents/current/ 为 checkpoint
│ ├── on-stop.sh / on-session-end.sh # 边界事件记录
│ └── lib-event-log.sh # 事件库：不可变、按月滚动、绝不阻塞主流程
├── skills/
│ ├── init-harness/ # /l123-harness:init-harness 装机（含 init.sh）
│ ├── event-review/ # /l123-harness:event-review 周审提炼
│ ├── tdd/ # 执行流的停止条件（红绿循环）
│ └── write-a-skill/ # 「连续成功 3 次 → skill 草稿」的落地工具
└── templates/ # 装机材料：L1/L2/gate.conf 模板 + 5 个工作模板
# 方式 A：本地开发/单机
claude --plugin-dir /path/to/l123-harness
# 方式 B：个人常驻（放进 skills 目录，自动加载为 l123-harness@skills-dir）
cp -r l123-harness ~/.claude/skills/
# 方式 C：git 仓库分发（本目录即单插件 marketplace）
# 他人执行：
# /plugin marketplace add <git-repo>
# /plugin install l123-harness
本仓库同时是标准 dsh 组合包（package.json 声明 dsh.bundle + 根目录
cordis.patch.yml），纯 JS 免构建，git 安装无需 pnpm 构建授权：
dsh plugin --profile web add github:reatcat/l123-harness
挂载时自动完成两件事：
ctx.skills，经标准 skill 工具
面向模型与用户可用（名称与 Claude Code 下一致）；@deepseek-ai/dsh-hooks-claude-code，
原样运行 hooks/hooks.json（CC/DSH 双宿主同一份钩子脚本）。| hooks.json 事件 | dsh 桥接 | 说明 |
|---|---|---|
| SessionStart（L2 注入 + 事件） | ✅ | 输出改为 JSON additionalContext，双宿主兼容 |
| PreToolUse（gate-guard 门禁） | ✅ | matcher 已含 DSH 的 edit/write/str_replace_editor；exit 2 → deny |
| PostToolUse（tool_error 记录） | ✅ | 纯观察事件 |
| Stop（边界事件） | ✅ | 纯观察事件 |
| PreCompact（压缩抢救） | ⚠️ 桥接未实现 | 配置被安全忽略，该能力在 DSH 暂不生效 |
| SessionEnd（边界事件） | ⚠️ 桥接未实现 | 同上 |
注：DSH 上
init-harness生成的骨架目录约定（CLAUDE.md/.agents/） 与 Claude Code 完全一致，两个宿主可共用同一个项目的记忆骨架。
/l123-harness:init-harness # 新项目装机：生成 L1/L2/L3 骨架 + 门禁清单
（日常干活：L2 索引自动注入；门禁自动拦截受保护文件；事件自动记录）
/l123-harness:event-review # 周审：读事件日志 → 候选进 inbox → 陪同分流
DSH 下同名技能经 skill 工具或用户命令调用（init-harness、event-review、
tdd、write-a-skill），日常自动化部分（L2 注入、门禁、事件记录）由 hooks
桥接在对应生命周期点自动运行。
touch <项目根>/.claude/.gate-token → 重试。.agents/inbox/ 干活时不得读取；候选不是结论。.agents/events/ 只读不改，不可变。MIT