oh-my-fable：AI Agent 工具实践指南

如果把oh-my-fable放进候选清单，不能只看热度；它的定位是克劳德寓言5.1提示指南为克劳德代码技巧（KO/EN/ZH）， Opus 5 和 Sonnet 5 的输出质量也有所提高。一旦进入软件开发环节，依赖、接口和异常处理往往比主路径更影响采用会直接影响交付，这也是我最关心的风险。更实际的做法是在隔离分支完成一个可回滚的小任务，同时核对安装步骤、接口契约、测试结果和错误信息，不要直接在关键项目上。它更像给需要可检查开发流程而非单次演示的工程师准备的可审查方案，是否长期使用应由试跑数据决定。

即使您发出大致一行的请求，它也会被转换为正确的请求并执行。

你击中了什么

/fable 로그인 버튼 눌러도 아무 반응 없어 고쳐줘

克劳德实际收到的请求（根据对话上下文自动填写）

목표: 로그인 버튼을 누르면 /api/login 이 호출되고, 성공하면 /dashboard 로 이동하게 한다
맥락: src/components/LoginButton.tsx, 콘솔 오류 "TypeError: onSubmit is not a function", 어제 인증 방식을 바꾼 커밋 이후 발생
범위: 이 버튼과 그 핸들러만. 옆의 회원가입 폼이나 다른 오류는 고치지 말고 후속 과제로 보고
완료 기준: 실제 클릭을 재현해 /dashboard 이동 확인, 콘솔 오류 0, 변경 파일 목록 첨부

只需安装，其余的都是自动的。

• 每个会话自动确定使用类型 · 如果是终端/IDE，则为交互式，如果是 claude -p·Agent SDK·Agent Harness，则检测为无人值守，然后添加“用户未观看”段落和“由于中间报告而不会停止”段落。即使混合起来也没有什么改变。
• 自动添加到子代理 · 将单独的简短版本插入到使用代理工具启动的子代理中（包括 Explore·Plan，它不读取规则文件）。
• 不创建文件 · CLAUDE.md 和规则文件都没有被触及，并且为每个会话插入钩子。所以，要更新，你只需要上传插件，如果删除它，就没有痕迹了。
• 不问任何问题 · 设置是可选的。您需要检查的只是安装批准。我推荐过一次/fable-setup rules-file。基本规则放在一个规则文件中，Claude Code hook 文档也说不改变的规则应该放在一个文件中而不是 hook 文本中。

Anthropic 官方文档 Prompting Claude Fable 5.1、Prompting Claude Opus 5.5 和 Prompting Claude Opus 5（Opus 5.5 指南）指定为起点。的处方包含在一钩四技能中。文字写得几乎与原文一模一样。

它适用于哪个模型？ Opus 5.5（现在是 Claude Code 的基本模型）和 Fable 5.1。两种模型的官方指南中的坚持到底、限制范围和进度报告的规则是相同的，并且仅适用于无人值守会话的“不要停止中间报告”段落来自 Opus 5.5 指南。部分编辑、批量调用工具和格式化规则仅在《神鬼寓言 5.1》指南中找到，但在其他模型中使用它们也没有什么坏处。无论模型是什么，四单元请求框架（目标、上下文、范围、完成标准）都可以减少重复检查和杂散结果。它还用于 Sonnet 5.5（Claude Code 基本工作 medium，与 Opus 5.5 相同）、Opus 5 和 Sonnet 5。如果会话以 xhigh 或 max 工作开始，则挂钩还会放置 Sonnet 5.5 指南中的块 N。

목차

• 무엇을 하나
• 설치: 한마디
• 사용법: 평소처럼
• 초보자 흐름
• 작동 원리: 세 층
• 1층 · 매번 요청에
• 2층 · 상시 규칙
• 3층 · 설정값
• 증상별 처방
• FAQ
• 구성
• 기여와 라이선스

무엇을 하나

在《神鬼寓言5.1》中，独立完成长任务的能力有所提高，但习惯发生了变化。您在工作时少说话，一次只调用一个工具，重写整个文件，即使是很小的编辑，并且使用记忆而不是搜索来轻松回答。 Opus 5.5 有一个习惯，只在长时间无人值守任务的中间报告进度，然后结束回合并在那里停止任务（官方指南“无人值守代理运行”）。官方指南是针对这些变化的特定症状处方，并且该插件会自动应用该处方。

설치: 한마디

就告诉克劳德·科德：

https://github.com/Junhan2/oh-my-fable 설치해줘

克劳德安装它，你就完成了。没有问题，没有配置文件。下次您打开 Claude Code 时，它将自动应用。如果您想在本次会话中立即使用它，只需加载 /reload-plugins（加载您刚刚安装的插件），然后逐行加载 /clear（注入规则）即可。

手动安装

claude plugin marketplace add Junhan2/oh-my-fable
claude plugin install oh-my-fable@oh-my-fable

打开一个新会话或 /reload-plugins 然后 /clear。没有什么可配置的。仅当您要更改默认值为 /fable-setup 时。

要求 Claude 代码 2.1.258 或更高版本。 Windows 需要 Git for Windows (Git Bash)：该挂钩在 bash 中运行。如果安装后出现hook错误，就是这个问题了。

自动续订 第三方市场的 Claude Code 默认关闭自动续订。如果您想自动获取新版本，只需一次：/plugin → 市场 → oh-my-fable → 启用自动更新。或者有时是 claude plugin update oh-my-fable@oh-my-fable。

60 秒路径：在我的环境中？

사용법: 평소처럼

只需像平常一样请求即可。常规规则已经开启。如果您的请求简短或模糊，请在其前面添加 /fable。

/fable 이거 좀 고쳐줘

它显示满足目标、上下文、范围和完成标准的请求并立即执行它们。如果您只想查看它，请添加 프롬프트만。

초보자 흐름

可选：更改规则位置 (/fable-setup)

三个规则位置（第一个问题）

推荐规则文件的原因 Claude代码钩子文档说“Put instructions that never change, Preferred CLAUDE.md in CLAUDE.md”（规则文件也以同样的方式加载），像系统命令一样写的钩子文本是Claude的，请注意，这可能扰乱你的即时注入防御。它默认为挂钩的原因是因为插件在安装时无法写入文件，并且出于同样的原因，挂钩文本以陈述事实的行开头（“用户安装了 oh-my-fable；这些是用户的常规工作规则。”）。规则文件的缺点是它们是副本。如果它已过时，它将在会话开始时通知您并使用 /fable-setup refresh 进行更新。

三者中只有一个处于活动状态。如果 CLAUDE.md 或自定义规则文件中有一个部分，则挂钩将自行静默（无双重注入）。从 1.7 开始，钩子直接处理子代理：在 Claude Code 的 SubagentStart 事件中，我们放置了一个简短版本（hooks/subagent.md，范围限制，部分编辑，批量调用，后续操作，“不要问，看看卡住了什么”）。 Explore·Plan 子代理既不读取 CLAUDE.md 也不读取规则文件，因此无论哪种方式它都会获得此快捷方式。

• 默认使用方式为自动检测。从终端或 IDE 打开时，它是交互式的，而从 Headless (claude -p)·Agent SDK·Agent Harness 打开时，它是无人值守的，并且为每个会话自动确定（基于 Claude Code 提供的 CLAUDE_CODE_ENTRYPOINT 值）。即使把互动和无人混合起来，也没有什么改变。要始终坚持一侧，请在问题中选择“交互式”或“无人值守”。无人值守增加了“用户没有观看”段落和“不要停止中间报告”段落，并且仅在全局设置中打开，无法通过存储库内的配置文件打开（以防止克隆存储库将代理变为无人值守）。自动检测有两种涉及钩子的方式，只有CLAUDE.md部分是固定文本，所以你必须选择一种。
• 此插件不使用 effort。 Opus 5.5 和 Sonnet 5.5 在 Claude Code 中默认为 medium（这两个指南都引用该值作为代理工作的起点），而 Fable 5.1 默认为 high。要按模型保存，请在使用该模型打开的会话中按 /effort <단계>，然后按 Enter，并且仅对于此会话，按 s。 /fable-status 现在显示值和来源。

AI 遵循的程序（克劳德阅读并执行此自述文件）

1. claude plugin marketplace add Junhan2/oh-my-fable
2. claude plugin install oh-my-fable@oh-my-fable
3. 从 ~/.claude/plugins/installed_plugins.json 读取 oh-my-fable@oh-my-fable 的 installPath
4. 一旦安装被确认，用户就会被简单地告知：“安装已完成。将从下一个会话开始自动应用。要立即使用它，请键入 /reload-plugins 并回车，然后键入 /clear 并回车（每行一个）。对于模糊的请求，请发送至 /fable <요청>。”
5. 不做进一步解释，也不执行/fable-setup（可选，默认运行，无需设置）。为什么需要两者：/reload-plugins 加载您刚刚安装到此会话中的插件（钩子/技能），并且规则注入仅发生在会话启动//clear/压缩时。

작동 원리: 세 층

指南的处方分为三层，使用方法不同。

1층 · 매번 요청에

一个好的要求是四个空格。

按要求补充：

• 当只是解释问题时 ·“只诊断，不修复。”指南中明确的例外情况。
• 当您需要最新信息时 · 投入大量精力或“搜索用户写下的名称一次”（H 框）。
• 努力 · 对于 Opus 5.5 和 Sonnet 5.5，medium 是默认值，也是指南的起点；对于 Fable 5.1，high 是默认值。仅上传该会话中的困难任务（/effort high，然后 s）。 low 可以跳过搜索。 xhigh/max需要更长的思考时间（Opus 5.5比同阶段的Opus 5需要更长的思考时间），长文档写两稿会很慢，所以附上长通知（G块）并慷慨地使用max_tokens。
• 文字密集时 · Please remove all mannered prose.
• 数据摘要 · 提供一个正确答案的示例（J 组）。

2층 · 상시 규칙

该插件的 SessionStart 挂钩会为每个会话加载下面的原始英语块（文件 hooks/always-on.md）。 CLAUDE.md 不会修改，并且无论用户的语言是什么，都是英语。块 A（“用户没有观看”）和块 M（“不要因中间报告而停止”）的第一段仅自动包含在 headless/SDK 会话中，并在终端/IDE 中被省略。始终放置 /fable-setup unattended。仅当会话以 xhigh 或 max 工作开始时才进入块 N（在 claude -p 中，钩子不接收模型，因此仅 CLAUDE_CODE_EFFORT_LEVEL 是参考）。钩子的每个部分都以一行陈述一个事实开始（例如“此会话是无头启动的（入口点 sdk-cli）；遵循此类会话的用户常设规则。”）。这是因为 Claude Code 挂钩文档告诉您将挂钩文本编写为事实句子而不是系统命令。

3층 · 설정값

• 模式 · ~/.claude/oh-my-fable.json {"enabled": true, "mode": "interactive" | 改为“无人值守”}。项目的 .claude/oh-my-fable.json 如果有的话，那是第一位的。 /fable-setup。
• 经过一番努力·/effort <단계>，回车按型号保存在settings.json中的modelSettings.<모델>.effortLevel中。旧的全局 effortLevel 不适用于 Opus 5.5 和 Sonnet 5.5。如果有一个环境变量 CLAUDE_CODE_EFFORT_LEVEL，它会获胜，因此如果您想为每个模型使用一个值，请将环境变量留空。如果存在 maxEffortLevel（全局或特定于模型），则任何值都会被截断到该上限，并且 /fable-status 显示截断的值。默认为Opus 5.5·Sonnet 5.5 medium，其他型号为high（Opus 4.7为xhigh）。每个阶段的实际事故数量因模型而异，因此不要直接传递其他模型的值。
• 直接链接到API · 仅当thinking.display: "updates" 打开时，屏幕上才会出现进度注释。仅附加对话历史记录（包括思维块），每个回合的通知都是回合范围的系统消息。压缩是服务器压缩或块K。
• 子代理 · 启动工具立即返回，导致稍后出现消息。 Claude Code 子代理继承了会话的工作，因此要修复它，请在代理文件 frontmatter 中写入 effort:。
• 视觉、图表和表格从添加裁剪和缩放工具中获益最多。
• 处理拒绝（stop_reason: "refusal"）·“能编译吗？”相反，问“有任何错误吗？”

증상별 처방

完整块文本：skills/fable/references/prompt-blocks.md

FAQ

如果 CLAUDE.md 已经有类似的规则怎么办？ 表中注明为/fable-setup。如果含义相同，则表示“已经存在”；如果意思相反（无格式，一次性报告），则建议替换一个句子。实际修改由用户进行。因为克劳德代码阻止了AI的CLAUDE.md自我修正。

我想将规则放在 CLAUDE.md 以外的地方。 默认情况下，不会创建 CLAUDE.md 和规则文件，因为规则仅位于插件内部，并且挂钩会放入每个会话中。推荐的设置是规则文件 (/fable-setup rules-file)。 Claude Code 说，不改变钩子文档的规则应该放在一个文件中，而不是放在钩子文本中，代理团队也会读取这个文件。 CLAUDE.md 部分是第三个选项。比较表位于初学者流程 [中的“选项”下。

这也适用于 Opus 5.5 吗？ 它有效。目前Claude Code的基础型号是Opus 5.5，所以从2.2.0开始，这两个型号都会作为标准。两本指南对于跟进、限制范围和进度报告说了同样的话，无人值守会议（M 块）中的“不要停止进行临时报告”段落来自 Opus 5.5 指南。格式化规则、部分编辑和批量调用工具来自《Fable 5.1》指南，因此它们在 Opus 5.5 中的作用可能较小，但它们是无害的。 Sonnet 5.5、Opus 5 和 Sonnet 5 也是如此。Sonnet 5.5 也从 Claude Code 中的 medium 开始，并覆盖用户设置中的全局 effortLevel，状态行显示了这一点。

如果我现在想写，为什么要先使用 /reload-plugins，然后再使用 /clear？ 根据官方文档，这两个命令执行不同的操作。 /reload-plugins“重新加载插件、技能、代理、挂钩和 MCP 服务器而无需重新启动”（插件）。插入规则的SessionStart钩子仅在“new session（启动），resume（恢复），/clear，compact，fork”上执行（Hooks）。换句话说，reload 只注册了钩子，并不执行它，所以你必须在已安装的会话中以 /clear 的形式运行一次。如果您打开一个新会话，则不需要两者。

想看看现在有什么节目吗？ /fable-status。在一张表中显示插件版本、规则位置、此会话的模式（包括自动检测原理）、工作量、规则文件版本和 CLAUDE.md 冲突，并且不会更改任何内容。当我打开一个新会话时，相同的内容在屏幕上显示为一行（但在克劳德的上下文中不是）。

如何恢复？ /fable-setup remove 清除配置文件、规则文件和CLAUDE.md 部分。然后是claude plugin uninstall oh-my-fable@oh-my-fable。如果您只是想关闭一段时间，请将~/.claude/oh-my-fable.json更改为{"enabled": false}。

无法安装插件的无头环境（单独的 CLAUDE_CONFIG_DIR、CI）怎么样？ 在该环境中将 hooks/rules-file-unattended.md 复制到 rules/oh-my-fable.md（或符号链接到此存储库签出）将加载整个无人值守规则，而无需插件。该钩子将此文件视为用户管理的文件并且保持静默。

/fable-audit 和 /doctor prompt-audit 有什么区别？ 你问的方向是相反的。 /fable-audit 查找我的规则中缺少提示指南中的哪些条款（要添加），而 Claude Code（2.1.283 及更高版本）中的 /doctor prompt-audit 会查找我的规则中过时、不正确或冲突的短语（要删除）。它们都不会自行修复，因此在组织设置时将它们都打开。

带有 omitClaudeMd: true 的子代理是否也会收到规则？ 您不会以规则文件或 CLAUDE.md 的形式收到它。 Claude Code 2.1.284，我在项目中没有看到任何用户定义的子代理 omitClaudeMd: true、~/.claude/rules/*.md、.claude/rules/*.md 和 CLAUDE.md，并且我看到所有三个相同的代理都减去了此设置。 Hooks 无法区分这些代理（仅在 SubagentStart 输入中给出代理类型），因此如果它是仅钩子方法，您将像其他子代理一样收到一个简短版本，如果它是仅钩子方法，您将不会从此插件收到任何信息。为了与此设置的精神（即轻松上下文）保持一致，在代理提示中放置必须触及的规则。

如果我直接通过 API 或 Agent SDK 附加它会怎么样？ /fable-setup 需要提问工具，因此 SDK 中仅接受 auto 参数。最简单的方法是将 hooks/always-on.md 的内容粘贴到系统提示符中。 3楼的API项目（thinking.display等）就是那个设置。

구성

oh-my-fable/
├── .claude-plugin/
│   ├── plugin.json            플러그인 매니페스트
│   └── marketplace.json       이 저장소를 마켓플레이스로 등록
├── hooks/
│   ├── hooks.json             SessionStart · SubagentStart 훅 등록
│   ├── session-start.sh       훅 본체 (세션 시작: 규칙 파일이 있으면 무인 문단만, 없으면 전체 · 서브에이전트: 짧은 판 · --status)
│   ├── subagent.md            서브에이전트에 넣는 짧은 판
│   ├── always-on.md           블록 원문 (영어)
│   ├── rules-file.md          /fable-setup이 ~/.claude/rules/oh-my-fable.md 로 복사하는 기본 규칙
│   ├── rules-file-unattended.md 플러그인 없는 헤드리스 전용 환경용 정적 규칙(무인 문단 둘 포함)
│   ├── effort-high.md         블록 N, 세션이 xhigh·max effort로 시작할 때만 추가
│   └── autonomy-unattended.md 무인 모드에서만 추가되는 문단 둘
├── skills/
│   ├── fable-setup/SKILL.md   충돌 점검·모드 전환·설정 점검 (2층·3층)
│   ├── fable-status/SKILL.md  지금 적용 중인 것 한 표로 (읽기 전용)
│   ├── fable-audit/
│   │   ├── SKILL.md           내 규칙을 가이드와 대조 (읽기 전용)
│   │   └── references/        가이드 절별 점검표와 모델별 주의점
│   ├── fable/
│   │   ├── SKILL.md           매번 요청 개선 (1층)
│   │   └── references/        블록 원문(A~N)과 전후 예시
│   └── fable-prompt/SKILL.md  /fable 의 옛 이름. 2.4.x 동안 그대로 동작
├── evals/                     `claude plugin eval` 평가 묶음: 사례 5개, 모델 판정 없이 규칙으로 채점
├── README.md · README.en.md · README.zh.md
└── LICENSE

기여와 라이선스

欢迎提出问题和 PR。当指南更新时，hooks/always-on.md（注入文本）、hooks/autonomy-unattended.md（无人参与段落）、hooks/rules-file.md（标记版本将被提升）、hooks/rules-file-unattended.md、hooks/effort-high.md和skills/fable/references/prompt-blocks.md（完整块列表）将一并纠正。要了解插件实际添加的内容，请运行 claude plugin eval . --scaffold --allow-tools Edit Write（在每种情况下，也运行非插件版本）。

MIT © Junhan2.原指南的版权属于 Anthropic。