Fable Soul 提供一套判断规则和工具,让 AI 编码智能体像资深工程师一样思考、验证和沟通,这些规则源自真实失败案例并经过行为验证。

Stars

106

7 天增长

暂无数据

Fork 数

26

开放 Issue

0

开源协议

MIT

最近更新

2026-07-08

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它将可执行的纪律(而非建议)打包为可加载的规则,配有红绿验证、针对模型借口的合理化表,以及同步/漂移检测工具,确保跨会话和机器的一致性。

适合谁使用

  • AI 编码智能体用户(如 Claude Code、Codex)
  • 依赖 AI 助手进行开发的软件工程师
  • 希望标准化 AI 行为并减少昂贵错误的团队
  • 为 AI 智能体构建自定义指令层的开发者

典型使用场景

  • 防止 AI 智能体不运行测试就声称‘完成’
  • 强制在修复 bug 前进行根因分析
  • 将更强模型的经验提炼为规则,供更便宜模型执行
  • 持续捕获并修复 AI 智能体反复出现的失败模式

项目优势

  • 规则来自真实 AI 失败案例,并通过红绿测试验证(evals.md 记录了压力场景)
  • 轻量:纯 Markdown 加两个小型 Python 脚本,无依赖,兼容多种运行器
  • 包含专门的合理化表,用于对抗模型常见借口,使规则更难被绕过
  • 模块化设计配合同步工具,确保唯一来源并检测多个安装位置的漂移

使用前须知

  • 需要手动设置和定期维护(如运行同步脚本、通过捕获循环扩充规则)
  • 效果取决于用户自身失败捕获和规则优化的质量
  • 全局安装时可能增加会话 token 使用量,但提供了紧凑版本以减轻影响

README 快速开始

Fable Soul

English | 繁體中文

A judgment layer for AI coding agents — make your AI think, verify, and communicate like a senior engineer.

MIT licensed · Works with Claude Code & Codex · Pure Markdown + two small Python scripts, no dependencies


The problem

Most AI agent failures are not knowledge failures. The model knows how to write the code. What it lacks is judgment — the operating discipline a senior engineer applies without thinking:

What the agent doesWhat a senior engineer does
Edits a file, says "Done! Fixed the bug." — never ran anythingRuns the test, pastes the output, then says done
Bumps the timeout because you asked, knowing it won't helpTells you the timeout isn't the cause, finds what is
"This should be much faster now""3.4s → 0.06s, measured"
Patches the symptom so the error message goes awayStates the mechanism in one sentence, fixes that
Diagnoses the real bug, then asks "want me to fix it?"Fixes it — it's in scope and reversible
Explains away a surprising test result to keep its story tidyStops and digs — surprise is where the real bug lives
Answers a one-line question with a 5-section reportAnswers in a sentence

Fable Soul packages the right-hand column as loadable rules. Every rule was captured from a real agent failure, written to prevent that specific failure, and tested to confirm it actually changes behavior. It is not a collection of "best practices" prose — it is operating infrastructure.

What's inside

fable-soul/
├── SKILL.md                        # Skill entry point (3 modes: Embody / Maintain / Transfer)
├── references/
│   ├── soul.md                     # The judgment rules — the core of this project
│   ├── soul-compact.md             # Token-lean rendering installed into global files (~40% smaller)
│   ├── maintenance.md              # Mirror map, sync procedure, failure-capture loop
│   ├── transfer-prompts.md         # 6 prompt templates for turning experience into skills
│   ├── evals.md                    # Behavioral eval scenarios + recorded RED-GREEN runs
│   └── worked-examples.md          # Captured failures with before/after receipts
├── examples/
│   └── hooks.json                  # Optional Stop-hook enforcement for Claude Code
└── scri

项目描述

A judgment layer for AI coding agents - make your AI think, verify, and communicate like a senior engineer

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390
slvDev
精选
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型
1,960
littledivy
精选
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI 与机器学习
1,482