SuperAPI AI 工具集

writing-descriptions

写作与研究

查看项目

更新于 10-16 00:29

技能介绍

该技能是一份描述写作指南,核心观点是:description 字段就是路由键,Claude 依据描述决定是否调用某个智能体或技能;描述写得差,产物就永远不会被触发。

用途:帮助编写智能体(agent)与技能(skill)的 description,使其在合适场景下被正确调用。

主要能力与模式:

  1. 提供公式:{角色/专长}。当{具体触发条件}时[主动]使用。角色/专长说明该智能体或技能做什么(技能用第三人称);若希望无需用户明说即调用则加入 PROACTIVELY;触发条件写明值得调用的具体情形。
  2. 分类示例:涵盖调试、代码审查、测试、基础设施、API 设计、性能、数据库、前端等智能体描述,以及文档处理、数据分析、API 集成、创意设计、工作流自动化、测试、PDF 处理、演示文稿等技能描述。
  3. 正反对比:指出“Helps with Docker”“General coding assistant”“Does database stuff”等模糊描述为何失败,并给出更具体的改写。
  4. 第三人称要求:技能描述必须用第三人称,如“Extracts text from PDFs and fills form fields.”;避免第一人称“I help you process PDFs.”和第二人称“Helps you extract PDF text.”。
  5. 主动与按需:当情形可从上下文检测(错误信息、文件类型)、等待明确请求会拖延用户、或该智能体/技能高度专业化时使用 PROACTIVELY;当用户应明确请求、存在多种可行方案、或操作有显著副作用时不加 PROACTIVELY。
  6. 触发条件具体化:用具体条件替代“when needed”“for code review”等模糊表述,例如“when containers fail to start or exit unexpectedly”“when queries exceed 100ms or EXPLAIN shows sequential scans”。
  7. 组合多个触发条件:可用“or”列出多个有效触发条件,用逗号连接相关触发条件。

限制:资料未说明该技能的安装方式、运行环境、是否收费及具体文件结构,这些信息暂未提供。