fable-domain

fable-domain

fable-method 提供领域适配器，将其循环转换为特定行业的术语。此技能可创建一个新适配器，并为用户提供该领域可用的分步工作流和流程图，让能力较弱的模型也能像 Fable 一样处理该领域。

其生成核心基于记录，而非猜测：两位 Fable 5 Agent 在没有任何流程提示的情况下，被要求“创建一个值得信赖、能与其他适配器媲美的适配器”，两者独立遵循了相同的流程（eval/results/round11-observed-traces.json）。下文的步骤标记为 [observed]（来自这些轨迹）、[covenant]（遵循仓库的“没有失败测试就不添加规则”原则所必需，即使前沿模型并不需要这些步骤），或 [v1.4]（此版本新增：讨论、红线和流程图输出）。之所以要有 covenant 和 v1.4 步骤，正是因为本技能面向领域知识和自我约束能力不如受观察模型的模型运行，因此需要通过讨论、获取的资料、红线和陷阱来弥补专业知识与判断力的不足。

产出内容（完整包含以下四项，否则视为未完成）

1. 领域工作流和流程图 [v1.4]。 从讨论和研究中提炼出的该领域分步处理方法，以及一张 mermaid 流程图，其结构与此方法自身的 references/flowcharts.md 一致。这是面向用户的成果，明确列出“按顺序执行的步骤”。它位于适配器的 Workflow 部分（见 TEMPLATE.md）。
2. 适配器，符合 references/domains/TEMPLATE.md 的要求，且每个列出的法规、政策或数据都必须在 Sources 部分附有获取的来源。
3. 陷阱测试样例，一个符合 eval/scenarios/ 结构的目录，其中的 GROUND-TRUTH.md 定义任务、陷阱（该行业的核心欺诈手段）、评分上限和理想行为。
4. 冒烟评测，进行 1–2 次对照组与适配器的运行，通过差异和执行情况进行评判，并标记为冒烟级；明确声明剩余问题，不得掩盖。

阶段 1：讨论 [v1.4]

制作技能是一项需要专注参与的有意行为，因此它不像无人值守的循环那样，而是从对话开始。灵活提问（不要照固定脚本）：实际用例是什么，由谁运行；在这个领域，什么才算“好”，从业者如何判断；用户信任哪些来源和权威；技能绝不能做什么；它具体应该产出什么。当你能向用户复述该领域的证据、权威和失败模式，并得到他们认可时，就可以停止。如果用户无法联系，请针对每一项说明你的假设并继续（此套件中的陷阱测试和冒烟评估是后备保障）。

红线（硬性拒绝，在讨论期间检查）。 如果该领域需要专业执照，或错误答案会造成身体、法律或财务伤害，切勿生成一份会伪装成专业能力的清单。这至少包括：医疗或临床诊断与治疗、法律建议（而非合规研究）、具体的金融买入／卖出／资产配置建议（而非分析）、心理健康以及安全关键工程。对于这些领域，应拒绝请求并转交给合格的人类专业人士：冒烟评估无法发现会导致他人受伤或被起诉的建议。任何与红线相邻的内容都必须经过人工签核，绝不能仅凭冒烟评估发布。此前已在文字说明中排除了医疗领域；现在则将其设为一道关卡，并扩大了排除范围。

范围止步（硬性提前退出，在讨论期间、任何研究或生成开始之前检查）。 如果请求涉及的行业无法用与编码默认领域真正不同的名词填充模板（其证据是文件和回溯信息，其权威是规范，其欺诈行为是该方法自身的失败模式），就在此处停止并说明该方法已经涵盖此领域；不生成适配器。调试、重构、测试和一般软件工作属于默认领域，而不是新的行业。此前这项检查在生成阶段才进行，一个能力不足的模型直接跳过了它，在构建过程中因势头使然而未能克制（第 15 轮）；像红线检查一样提前询问，只需多花一句话，且不会在尚未开始工作时造成损失。

阶段 2：研究 [covenant]

以讨论内容为基础，进行范围有限的网络研究，并在此时获取资料：从业者视为什么是证据、真正的权威是谁、约束该领域的现行法规和平台政策，以及有据可查的失败模式（欺诈表的原始素材）。凡是提及法规、政策、阈值或实践的说法，都必须在“来源”部分附上链接和访问日期。无法访问网络，就无法制作可信的套件：请说明这一点并停止，而不是穿上记忆的外衣发布内容。（观察到的运行跳过了这一步，直接依据前沿知识开展工作；消除这种依赖正是创建此技能的原因。）

阶段 3：生成套件

1. 了解情况并阅读所有现有适配器，而非抽样阅读［实测］。 列出安装内容；阅读 references/domains/ 中的每个适配器，以及相关规范文档（方法 SKILL.md 路由器、fable-judge、流程图、README、CHANGELOG、TEMPLATE.md）。模式是从语料和模板中共同学习得来的。
2. 界定领域范围［实测］。 用一句话说明适用条件，再用一句话划定边界，指出最近的适配器或默认编码适配器，以及何时由哪一方接手。（无需适配器的退出流程已在阶段 1 执行；到达此步骤意味着该领域值得拥有自己的适配器。）
3. 编写工作流及其流程图［v1.4］。 在适配器的 Workflow 部分中，写出从业者（或能力较弱的模型）在该领域要遵循的有序步骤，以及这些步骤的 mermaid 流程图。步骤必须具体且可执行，不要流于愿景；每一步都应指出要打开、产出或检查什么。
4. 按照 TEMPLATE.md 编写适配器［实测模式］。 完整保留各节标题（CI 会对其进行 grep）；最低证据集必须包含每次都实际需要打开的内容。
5. 接通所有路由入口［实测］。 更新方法 SKILL.md 的适配器段落、流程图路由器、README 适配器列表及计数、fable-judge 的领域列表（若其中列举了领域），以及 CHANGELOG。README 和流程图路由器中的副本必须逐字节相同。
6. 构建陷阱测试夹具［约定］。 规模小、只涉及一个决策、几分钟内可运行：诱人的做法必须是该领域的核心欺诈行为，正确做法必须遵循工作流中的规范，违规行为必须能客观检测（例如差异、标记文件或重新计算）。GROUND-TRUTH.md 应包含任务提示词、陷阱、0/1/2 分上限和理想行为，且绝不能提供给受测 Agent。

阶段 4：验证、冒烟评测并报告

1. 以机械方式验证［实测］。 运行仓库自带的检查脚本；修复所有失败项。
2. 冒烟评测［约定］。 通过 fable-judge 套件模式，或针对技能发现案例使用无头测试框架，分别在不使用套件和使用套件的情况下运行夹具。一个随机种子只是冒烟测试，不是基准测试；应明确标注。如果陷阱未显示出差异，应报告该套件尚未得到证明，而非已通过验证。
3. 评审套件［v1.4］。 交付前，使用 fable-judge 检查套件自身的所有声明：每个具名来源都确实已获取（至少抽查一个）；陷阱在三种状态下均已验证（存在错误、修复错误、修复正确）；所有路由入口均已实际接通；冒烟评测的数字与实际运行结果一致。未通过评审的套件尚未完成。之所以需要此步骤，是因为能力较弱的模型制作者会夸大成果（实测：第 13 轮中，未使用套件的 Haiku 将未经验证的套件称为“可用于生产环境”）；评审机制就是最后一道防线。
4. 先报告结果。 列出套件清单、验证内容及方式、已获取的来源，以及诚实说明遗留问题的一行说明。报告应与实际运行结果相符；这些运行记录会在无人提示的情况下主动说明评测债务。

flowchart TD
    A["/fable-domain <sector>"] --> DIS["Discuss: use case, what good looks like,<br/>trusted authorities, must-nevers, outputs"]
    DIS --> RL{"Red-line domain?<br/>licensure or high-harm"}
    RL -->|yes| STOP["Refuse the checklist.<br/>Route to a qualified human"]
    RL -->|no| SCOPE{"Nouns genuinely differ<br/>from coding default?"}
    SCOPE -->|no| NOAD["Stop: no adapter needed,<br/>the method already covers it"]
    SCOPE -->|yes| RES["Research now: evidence, authorities,<br/>regulations, documented failure modes"]
    RES -->|"no web access"| NOSRC["Stop: no sources,<br/>no trustworthy bundle"]
    RES --> ORI["Orient + read ALL adapters"]
    ORI --> WF["Write the workflow + flowchart,<br/>then the adapter to TEMPLATE.md"]
    WF --> WIRE["Wire routing surfaces;<br/>build the trap fixture"]
    WIRE --> CHK["Run repo checks"]
    CHK --> SMOKE["Smoke eval: bare vs bundle"]
    SMOKE --> JDG["fable-judge pass on the<br/>bundle's own claims"]
    JDG --> REP["Report: inventory, sources,<br/>smoke-grade label, declared debt"]

边界

• 已有适配器覆盖的领域，应更新适配器，绝不重复创建。
• 适配器最后可以添加一行“配套技能”，列出与该领域相关且已安装的技能，供人类读者参考；但绝不指示调用这些技能（我们用四种措辞进行了十四次测试，发现自动技能发现无法迁移到弱档模型；相关负面结果已发布）。
• 用户批准门槛按本方法执行：在工作副本中写入文件是可逆的；发布、提交 PR 或提交该捆绑内容都需要用户明确授权（授权门槛）。
• 此技能用于构建领域工作流程，并不赋予领域权威。设置红线、烟雾测试级别标签和 Sources 部分，是为了让人类专家能在几分钟内审查捆绑内容，并确保有害领域根本不会获得检查清单。
• **小模型边界，以实测为准，而非猜测。**生成质量取决于模型（在第 12 轮的标准下，Sonnet 为 9–10 分，Haiku 为 6 分；在 Stage 1 的范围停止机制尚未设立时，一次 Haiku 运行还为编码默认项生成了多余的适配器）。请在中档或更高档模型上运行制作流程，或由人员全程监督；拒绝门槛在弱档模型上仍有效，但生成质量不会。