fable-method

Fable 方法

遵循此循环的中等水平模型，表现胜过自由发挥的更强模型：质量取决于结构、证据和诚实，而非模型本身。此循环是自包含的。请严格遵循。

目的

针对各种问题形态，提供一套通用且严谨的工程循环：对需求分类、定义完成标准、收集证据、做出决策、精准执行、通过观察验证，并优先报告结果。

适用场景

• 用户明确要求使用 Fable 方法（/fable-method、“像 Fable 一样处理”）。
• 开始一项含糊的多步骤工程任务，且没有预先指定专门的专家。
• 执行结构化规划（/fable-method plan <task>）。
• 根据生命周期不变量审查现有对话中的工作（/fable-method audit）。

不适用场景

• 一行即可完成、改动明显且范围明确的简单编辑（直接执行）。
• 纯自主的后台长轮询或测试循环（使用 fable-loop）。
• 多主机安装和设置流程（使用 fable-release 或安装程序）。

输入

• task_description：问题提示、规格说明或错误报告。
• domain_adapter：可选的行业适配器（references/domains/*），用于非代码领域。

预期输出

• verified_solution：精准实施且符合规格的改动。
• execution_evidence：可观察的证据，证明解决方案按预期运行。

流程

1. 简单任务关卡：如果任务只涉及一个文件、少于约 10 行、没有新增行为且编辑内容明确，则直接执行并进行一项检查确认。
2. 适用性关卡：判断答案所在位置：可访问的源中（运行循环）、未知的外部技术中（先研究），或只能通过推断得出（标记低置信度）。
3. 步骤 0 — 对需求分类：
   • 问题 / 评估：报告发现，不做任何更改。
   • 任务：实施并验证。
   • 优先规划：如果范围含糊或操作不可逆，先制定计划并等待批准。
4. 步骤 1 — 定义完成标准：明确说明完成状态是什么，以及如何验证。
5. 步骤 2 — 收集证据：在修改状态前，打开源文件、阅读相关代码，并查阅权威文档。
6. 步骤 3 — 做出决策：制定最小可行计划。
7. 步骤 4 — 精准执行：只修改必要的行，不产生任何附带偏移。
8. 步骤 5 — 通过观察验证：运行代码、执行测试并观察副作用。
9. 步骤 6 — 优先报告结果：在第一句话中说明结果。

决策规则

• 优先规划：如果涉及任何不可逆操作、破坏性命令或含糊的范围，应优先规划，而非直接执行任务。
• 范围关卡：不得触及限定问题领域之外的文件。
• 证据关卡：只有观察到最新且通过的机器证据，任务才算完成。

工具策略

• 执行 shell 命令来运行编译器、代码检查工具和测试运行器。
• 使用有针对性的文件读取和编辑工具。
• 处理非编码任务（营销、运维、财务、DevOps）时，查阅 references/domains/ 中的领域适配器。

证据要求

• 测试运行器或构建工具的直接终端输出。
• 源代码行引用，用以确认错误机制及修复内容。

失败处理

• 如果某一步失败，应诊断失败机制，而非盲目重试相同操作。
• 如果连续失败两次，立即转交给 fable-recover。

完成标准

• 满足步骤 1（“定义完成标准”）中定义的所有标准。
• 已采集最新且通过的测试证据。
• 最终报告优先说明结果，不含任何冗余内容。