SuperAPI AI 工具集

writing-skill

写作与研究

查看项目

更新于 10-15 20:08

技能介绍

用途:把跨机器、跨项目会重复的方法(怎么做、怎么避坑)写成可移植的 skill,并支持在既有 skill 上增删改查。触发场景为用户说“写个skill/固化成skill/沉淀成skill/把这个流程做成skill”,或某条经验被跨会话反复重教。

主要能力与流程:

  1. 先判定是否值得做 skill:跨机器/跨项目重复的方法写成 skill;只对本机/本项目成立的事实(路径、版本、状态)放记忆系统或 host 层文档;一次性任务先不写;agent 通识不写,只写它不知道的差异点(确切键名、命令、版本行、坑)。混了本机事实的通用方法需占位符化(如 {{路径}}),本机值进 host 层或记忆。
  2. 定形:命名用 kebab-case,动词或名词短语,≤64 字符,目录名等于 name,前缀可对齐家族(exp-、accel-)。放置位置分仓库 base 组(全机型通用)、accel 组(算力场景)、本机 ~/.agents/skills/(只此一机);进仓库的要进 setup 脚本对应名单。与相邻 skill 的边界一句话写进 description。演化性质分经验演化型、事实冻结型、固定指令型,并明确更新约定与安装策略。
  3. description:第三人称或祈使,写 what + when + 触发词,含中文口语触发词,≤1024 字符,只写触发所需,不写实现细节。
  4. 正文:上限约 150 行,只留影响执行的信息;steps 与 reference 分开,步骤内联在 SKILL.md,查表类推到同目录附属文件,指针只一层深;每步有可观察的完成判据;易错处给精确命令,判断处给启发式;细节写差异点(确切命令、键名、版本行、真实踩坑的症状→原因→处置);时效内容带日期,未验证标 (未验证);中文为主。
  5. 收尾检查:用 2–3 句真实用户话术做触发测试,检查相邻 skill 是否抢触发;做信息与扫读检查;grep 本机痕迹并占位符化;首次真用后再按需调整。
  6. 演化:真机改本机副本 → 下载到开发机 → 合入仓库 push → 各机拉新版;最小修改回到 skill 本体;覆盖刷新组自动、只装一次组显式重装;本机修改未回流前别重跑 setup 的覆盖刷新。

限制:资料未提供具体安装命令、依赖、平台支持范围与收费信息;正文行数、description 字符数等为规范建议值,实际以所在环境为准。