agentleFS
kafnosakekafnosake/Ensoul/skills/find-recipe/SKILL.md

find-recipe

Skill1 starsChanged 43 days agoMITView on GitHub

技能无法解决或重复失败时,优先找以前的做法:recipe_search 按需查角色经验与 work 文档,再查历史;不可用时用限定目录的关键词检索

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

找做法

先记住这条:技能清单里没有 ≠ 没干过。 清单是精选过的少数几条,大量的做法散在 角色卡、工作区文档和历史会话里 —— 没有哪份清单列着它们,但它们真发生过。

一、什么时候该来找(判据要可数)

命中一条就动手找,别硬趟:

  • 同一个工具连错两次(第二次还错、就想去试第三次,这就是该停下来找前例的时刻)
  • 同一步骤卡了两轮没过去
  • 用户说「以前弄过 / 上次那个 / 再来一遍」
  • 你要动手,但手上没有对应的技能,也拿不准该调哪个工具
  • 结果出来了但验收没把握(不知道"算不算成")

不该来的:一次就能成的活、查文档就能答的问题、纯问答。 找做法本身要花几轮,别把它变成新的拖延。

二、四处库存,按可靠度往下找

#在哪找什么可靠度范围
1技能正文(use_skill)正式流程最高:跑通过、写全了通用
2角色卡 learned[]员工学会的工作流高:作者跑通过、留了要点员工专供(只读)
3work/ 下的文档回执、规格书、对照记录中:现场原始记录通用
4history_search / history_read历史会话低:可能半途而废,得自己判通用

第 2 处人人都能读、只有员工能往里写 —— 它是"这个人会什么",不是公共仓库。

具体落点:

  • 角色卡:.ensoul/state/agents/*.json 的 learned 字段,每条 {name, how, at}。这是最容易漏掉的一处 —— how 里往往就写着踩过的坑。
  • 工作区文档:work/<员工名>/,以及 work/ 根上那些 *-specs.md、 *-presets.md、*-fix.md。
  • 历史会话:用 history_search 查关键词、用 history_read 按会话编号取必要部分。当前正文在 ensoul 用户数据目录的 panels/、closed/、components/,不假定在工作区里。旧 .ensoul/state/histconv/ 只有确实存在时才按目录查。
  • 顺带能看出来的:.ensoul/state/ 里那几个账本(inbox / drop / board)—— "这单当初怎么派出去的、谁接的",常在那儿。

三、怎么搜(省 token 的搜法)

  • 本轮工具里有 recipe_search 时,先用简短的问题描述调用:{query:"问题、环境与期望结果"}。默认只检索角色卡 learned[] 和 work/ 文档,最多 3 条、正文合计 3000 字符,不加载整份库存。
  • 前两处没有合适做法,再带 includeHistory:true 查已启用的会话范围。返回的 recipeType 标明角色经验、工作文档或历史;相似度只是线索,不证明案例成功。
  • 结果有来源、步骤与 truncated 标记。未截断且已足够判断时不要再把整份文件读一遍;截断或缺少验收信息时,按来源取必要原文。
  • 工具未提供、语义搜索关闭、模型或索引未准备时,直接用下面的关键词路径,不反复重试、不触发安装。历史改用 history_search / history_read,工作文档与角色卡用限定目录的 search。
  • 用 search,一定带 path 限定到一个子目录。在工作区根上搜会把这个盘上 所有项目翻一遍 —— 慢、贵、还捞一堆无关的。
  • 关键词用中文短词 + 物件名("抠图""图集""色键"/"头像""压缩"),别拿整句话搜。
  • 两次不中就换个说法再来一次,再不中就往下走,别在搜索上耗。
  • 搜到了就读原文档,不要照着搜索片段猜步骤。

四、怎么算"找到了"

前例能用,要同时满足三条:

  1. 情境对得上 —— 同样的输入类型、同样的工具、同样的环境。差一条就要警惕。
  2. 带着反例 —— 文档里写了"什么时候不适用"。只写怎么成功、不写哪儿会翻车的, 多半是没趟透。
  3. 有验收口径 —— 说得出"怎么看它成了"(看哪个数字、哪张图、哪个字段)。

三条缺一条,就当"有人干过这类事",但别照抄 —— 照着第 1 条的原则自己重做一遍。

五、都没有怎么办

那就自己趟。趟的时候顺手做两件事:

  • 一路记:哪一步错了、错在哪、怎么绕过去的。事后再回想全是模糊的。
  • 成了就写回去 —— 走通用那条路:
    • 照做的步骤、只有这件事用得上 → 写进 work/<主题>.md
    • 通用、别人也会用 → 升格成技能:skills/<名>/SKILL.md,正文写全
    • 不成流程的判断("一轮能收的活别做十轮探路")→ 跟着文档存,别硬凑成技能
    • learn(存进角色卡)是员工专供:它写的是"你这个人会了什么",名字会进 那张卡的 skills、派单挑人时直接命中。只有带角色卡的员工面板才用它 —— 普通面板用它,等于给自己的活建了一份没人看的档案。

单向阀:升格成技能之后,原处的抄本删掉、或改成一行指针。 两处各存一份,迟早对不上。

六、写进库存的硬要求

不管存在哪,四条必须齐:

  • 适用条件:什么输入、什么环境、什么前置
  • 步骤:能照着做的短路 —— 不是"注意一下""小心一点"
  • 反例 / 边界:什么时候不该用;试过但走不通的路
  • 给谁用:拿不准就写进 work/;确认通用才升格成技能。 别默认往角色卡里塞 —— 那是员工的履历,普通面板塞进去没人会看

跑通并验收过才写。 没验过的猜测写进去,就是给后面的人挖坑。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.