用途:把刚刚费劲摸索出来的可行路径,保存为可复用的 Agent Skill,让下一次会话(自己或队友)不必从头再找一遍。它不替你做工作,只记录工作是怎么做成的。
主要能力:识别值得收割的时机——多次尝试或用户纠正后才成功的任务、新发现的项目专属事实(凭据/环境变量位置、非常规命令、必需顺序)、可能复现的运维流程(连数据库、部署、跑迁移、验证变更)、用户明确说“记住这个”。支持任意读取 Agent Skills 格式的工具(如 Claude Code、Codex),与工具无关,通用写法在前,工具特例仅作示例。
提升门槛:写入前须满足三条——有通过的检查(测试通过、命令干净退出等,并记录检查是什么);能命名所规避的失败模式;至少一条已排除的具体死路。缺任一条则不算技能,只能记为未验证的临时笔记或跳过。
用法:先做三选一分流——多步可复用流程写成技能;孤立事实或一行纠正放入轻量记忆(如 MEMORY.md);一次性事件跳过。随后按七步流程:应用提升门槛、自行选定作用域与名称、去重(查项目级与用户级技能目录,如 .claude/skills 与 ~/.claude/skills、.codex/skills 与 ~/.codex/skills)、从当前会话提炼黄金路径、委托有上下文的子代理或内联写入、回报路径与摘要。默认项目作用域,不确定时优先项目级;名称须为小写字母数字连字符且等于目录名。
限制:绝不写入任何密钥值(密码、令牌、连接串、API 密钥),只记录其位置来源,这是最重要规则。写入时须框定在技能目录内,不得改动项目源码或恢复原任务。SKILL.md 保持精简(500 行以内),细节放入 references/。避免重复,已有近似技能应更新而非新建。捕获流程而非一次性答案,并记录失败路径。未提供具体价格与收费信息。