oh-my-fable · Claude Fable 5.1 提示工程自动化插件

技能简介

oh-my-fable 是一款面向 Claude Code 的插件，将 Anthropic 官方 Fable 5.1 提示工程指南转化为自动化工作流。用户只需给出模糊的任务描述，插件即可将其转化为包含目标、上下文、范围边界与验收标准的完整请求，并在随后的整个会话中持续执行 Fable 5.1 的全部工作规范，实现安装后零配置、每次请求自动优化的使用体验。该插件同时支持 Opus 5 和 Sonnet 5 模型，在非 Fable 5.1 模型上同样能显著提升输出质量。

核心能力

能力一：四栏结构化请求优化。 当用户给出模糊或简短的请求时，使用 /fable-prompt 命令可将请求即时转化为四栏结构化提示（目标、上下文、范围边界、验收标准），直接执行而非仅仅展示，从根本上解决说了很多但 AI 仍然理解偏差的问题。

能力二：会话级六条规则自动注入。 插件通过 SessionStart 钩子在每次会话开始时自动注入 Fable 5.1 的六条核心规则：自主执行（无序操作直接推进，只在破坏性行为前暂停）、范围与测试边界（不修改范围外内容）、部分编辑优先（相同结果下不重写整个文件）、进度报告规范、格式规则（多内容用列表）、工具批量调用（独立操作合并一次请求）。

能力三：智能环境自动适配。 插件自动检测当前使用环境，终端或 IDE 识别为交互模式，claude -p、Agent SDK、CI 等环境识别为无人值守模式，并自动添加相应语言提示，无需用户手动切换。

能力四：子代理规则自动覆盖。 对 SubagentStart 事件进行拦截，为所有子代理（包含 Explore 和 Plan 等不读取规则文件的子代理）注入范围限制与完成规范，解决子代理容易超出指令范围工作的常见问题。

能力五：CLAUDE.md 冲突自动检测。 /fable-setup 提供冲突检测功能，可识别现有 CLAUDE.md 中与 Fable 5.1 规范矛盾的规则，并给出替换建议，用户确认后手动修改，避免自动覆盖带来的行为不一致。

能力六：多端配置统一管理。 支持全局配置与项目级覆盖，项目级配置优先级更高，方便团队成员在不同项目中共享不同设置，实现配置与代码库同步管理。

安装配置

方式一（一句话安装，推荐）： 在 Claude Code 对话框中直接发送仓库地址（https://github.com/Junhan2/oh-my-fable 安装），Claude 将自动完成注册市场、安装插件、注入会话钩子、给出使用指引的全部流程。安装后按提示执行 /reload-plugins 和 /clear 使当前会话立即生效。

方式二（手动安装）： 通过 claude plugin marketplace add 和 claude plugin install 两条命令完成安装，随后执行 /reload-plugins 和 /clear 使钩子生效。整个过程一次性完成，无需逐文件配置。

配置优先级： 插件配置写入用户目录下的 oh-my-fable.json，支持全局配置与项目级覆盖，项目级配置（项目目录下 .claude/oh-my-fable.json）优先级更高。安装后默认以自动检测模式运行，依据 Claude Code 自动注入的环境变量判断当前使用环境。

依赖要求： Claude Code 2.1.258 及以上版本。Windows 用户需要安装 Git for Windows（Git Bash 环境），因为钩子脚本依赖 bash 执行。

使用步骤

步骤一：一句话安装。 在 Claude Code 对话框发送仓库地址即可完成全部安装流程，按提示执行 /reload-plugins 和 /clear 使当前会话立即生效。

步骤二：直接发起自然语言请求。 之后以正常方式描述任务，插件自动进行结构化处理。请求简短或模糊时，在前面加上 /fable-prompt 命令可查看完整优化后的四栏结构并直接执行；末尾加只看提示词则只展示结果而不执行。

步骤三：查看当前配置状态。 运行 /fable-status 可查看插件版本、规则注入位置、检测到的环境模式、effort 等级、规则文件版本以及与 CLAUDE.md 的冲突情况，以表格形式呈现，不对系统做任何修改。

步骤四：按需调整默认设置。 运行 /fable-setup 可修改规则注入方式（钩子注入 / 规则文件 / CLAUDE.md 分段）、固定环境模式、设置默认 effort 等级、排查与 CLAUDE.md 的冲突。不需要调整时此项可完全跳过。

适用场景

场景一：代码审查与重构。 当需要对某模块进行重构时，使用四栏结构明确重构边界、目标代码特征、验收测试用例范围，避免 AI 在无关模块中引入变更。

场景二：跨文件功能实现。 涉及多个相关文件协同修改的任务，使用范围边界栏明确本次工作的边界，同时用验收标准栏定义功能完成的判断条件，确保交付物符合预期。

场景三：自动化测试编写。 通过上下文栏提供被测函数的签名与行为描述，通过验收标准栏定义测试覆盖的边界条件，通过范围边界栏防止测试用例覆盖超出被测模块范围。

场景四：Agent 团队协作。 在 Claude Code 的 Agent 工具中启动子代理执行子任务时，插件自动为子代理注入范围限制与完成规范，解决子代理容易超出指令范围工作的常见问题。

场景五：无人值守与 CI 环境。 在 claude -p 模式、Agent SDK 或 CI 流水线中运行时，插件自动切换至无人值守模式并添加相应语言提示，确保远程执行场景下的行为规范与交互模式下一致。

适用人群

oh-my-fable 适合以下用户群体：日常使用 Claude Code 进行代码开发的工程师，特别是需要编写复杂多文件任务或多轮迭代工作的开发者；在 CI/CD 流水线中集成 Claude Code 的 DevOps 工程师和自动化脚本维护者；使用 Agent SDK 构建 AI 辅助开发流水线的团队；以及对 Fable 5.1 提示工程方法论感兴趣、希望在不切换模型的情况下在 Opus 5 或 Sonnet 5 上获得更好输出质量的 LLM 应用实践者。

工作原理

oh-my-fable 的核心设计原则是让规范自动生效，而非依赖人工记忆。三层体系各自承担独立职责：第一层通过 /fable-prompt 命令在请求发送前完成结构化；第二层通过 SessionStart 钩子在每次会话开始时将规则注入系统提示；第三层通过 SubagentStart 钩子为所有子代理补充规范。这种分层设计确保了从单次请求到整个会话再到多代理协作的所有层级都有对应的质量保障机制，而无需用户在每次交互中手动应用规则。配置系统采用自动检测优先、手动指定备用的逻辑，优先读取项目级配置文件中的 mode 字段，在该字段缺失时才回退至全局配置或自动检测结果。

官方链接

• GitHub 仓库：https://github.com/Junhan2/oh-my-fable
• 中文说明：https://github.com/Junhan2/oh-my-fable/blob/main/README.zh.md
• 插件市场：Claude Code 插件市场搜索「oh-my-fable」安装