docs: rescan rebased documentation hierarchy

This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions

View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/hooks/README.md
README.md: 23478fb5e9b813a3370ce465104b1f9db8b0a26a
README.zh.md: 778d5f334e5952a5b4ce08d52053144c048d4e8a
README.md: 35989292313c6cef47c02041eb671a73ff7c5786
README.zh.md: b5187fed159b0eaf5b2bace192152e612a85bc55

View File

@@ -1,13 +1,13 @@
# hooks/hook 桥接 + 共享协议
# hooks/ — 钩子桥接与共享协议
[English](README.md) | 中文
hooks 子系统让用户可以像使用 Claude Code 和 Codex 一样,在 agent智能体生命周期节点扩展 agent把桥接插件指向现有 `hooks.json`(或 settings即可忠实运行这些外部 shell hook。规范扩展表层本身是 harness 的类型化拦截 seam见[拦截 seam Agent Note](../../.agents/notes/implemented/feature/2026-06-30-interception-seams.md)原生 hook」只是这些 seam 上的普通 Cordis 插件。这些包是把外部 shell-hook 协议转换到同一表层的**桥接**另含它们共同依赖的共享协议格式wire format库。
hooks 子系统让用户像使用 Claude Code 和 Codex 一样,在生命周期节点扩展 agent(智能体):把桥接插件指向现有 `hooks.json`(或 settings即可忠实运行这些外部 shell 钩子。规范扩展 surface 本身是 harness 的类型化拦截 seam见[拦截 seam Agent Note](../../.agents/notes/implemented/feature/2026-06-30-interception-seams.md)原生钩子”只是这些 seam 上的普通 Cordis 插件。这些包是把外部 shell 钩子协议转换到同一 surface 的**桥接**也包括它们共同依赖的共享协议格式库。
| 包 | 职责 | 形态 |
|---|---|---|
| [`hook-protocol/`](hook-protocol/README.md) | 共享 shell hook 协议库 | 库 |
| [`hooks-claude/`](hooks-claude/README.md) | Claude Code hook 桥接 | 插件 |
| [`hooks-codex/`](hooks-codex/README.md) | Codex hook 桥接 | 插件 |
| [`hook-protocol/`](hook-protocol/README.md) | 共享 shell 钩子协议库 | 库 |
| [`hooks-claude/`](hooks-claude/README.md) | Claude Code 钩子桥接 | 插件 |
| [`hooks-codex/`](hooks-codex/README.md) | Codex 钩子桥接 | 插件 |
共享库负责通用协议行为;每个桥接负责其方言特有的事件映射。相应契约由子级 README 记录。
共享库负责通用协议行为;桥接负责自身方言的事件映射。 README 记录这些契约