用途:该技能帮助用户创建新技能并改进已有技能,核心是把一次性解决的问题沉淀为可复用的知识,避免下个月重新摸索,让其他会话和其他用户也能受益,并把复杂工作流变成可重复的流程。
基本格式:技能放在一个文件夹中,内含 SKILL.md,例如 .factory/skills/my-skill/SKILL.md。文件包含 YAML frontmatter 和 markdown 内容,frontmatter 含 name、version、description 等字段;description 很关键,智能体据此判断是否为某任务加载该技能,因此要具体说明它解决的问题。
何时创建:技能适用于可能被重复或分享的复杂、较长的工作流,简单的一次性任务不值得建技能。具体程度要平衡:太宽泛或太窄都不好。可以自问:是否曾费力摸索才弄明白?是否不愿从头再解一遍?文档中是否有不明显的内容?有则值得提取;技能也可记录偏好与最佳实践。可用 session-navigation 技能翻查过往会话,寻找反复出现、费力解决或重复的工作流,并将其泛化,把具体路径替换为模式,注明前提与假设。
设计建议:撰写时使用 human-writing 技能,避免营销式文风;从小处着手,一个技能做好一件事;加入验证步骤,说明如何确认技能生效;也记录失败与不应做的事;保持更新,技能会过时,失效或过时就要更新或删除。
存放位置:.factory/skills/ 对项目所有人可见,应提交到 git;~/.factory/skills/ 仅自己跨项目可见。项目技能适合团队约定,个人技能适合自身工作流。
改进已有技能:用户追问、反复出现边界失败、已有更好方法时都需要改进。可用命令查找模式,例如 rg -l "skill-name" ~/.factory/sessions/.jsonl 与 rg "error|failed|retry" ~/.factory/sessions/.jsonl -C 3;更新技能时应提升版本,若为破坏性变更则提升主版本。资料还提及相关学术研究(Voyager、CASCADE、SEAgent、Reflexion)及一个工作循环。原文未提供收费、价格与平台支持等信息。