SuperAPI AI 工具集

skill-writing

写作与研究

查看项目

更新于 10-16 00:01

技能介绍

用途:该技能指导开发者为 loxosceles-dev/dev-skills 仓库创建和修改技能文件,规定技能的类型体系、frontmatter 约定与行为指令写法。

主要能力:定义两种技能类型。type: guideline 为严格规则,代理必须逐条遵守,适用于编码规范、提交格式、命名约定、工作流规则、安全要求;开头需写 This is a strict guideline. Follow these rules exactly.。type: pattern 为参考实现,代理应学习思路并按自身场景调整,不得照抄,适用于架构方案、基础设施搭建和常见问题的成熟做法;开头需写 This is a reference pattern. Learn from the approach, adapt to your context — don't copy verbatim.。

使用方式:每个 SKILL.md 必须以 YAML frontmatter 开头,需包含 name(kebab-case,作为 skills CLI 安装目录名)、description(触发条件,第一句应能作为触发语,最长一至两句)、type(guideline 或 pattern)。文件存放在 skills/guidelines/{skill-name}/SKILL.md 或 skills/patterns/{skill-name}/SKILL.md;目录分类仅供人工浏览,CLI 安装时会扁平化,只认 name 字段。若需覆盖第三方技能的冲突建议,可显式声明优先级,但应节制使用。

结构要求:pattern 技能建议按 Problem、Solution、Pattern、Why This Pattern?、Implementation(可选)、Tradeoffs、When NOT to Use(可选)组织,代码示例保持最小化和通用,使用占位名。guideline 技能按 What、Rules、Examples、Exceptions(可选)组织,用祈使句直接表达。

检查清单与演进:需核对 frontmatter 三字段、标题后行为指令行、description 触发句、无项目专属细节、示例简洁、文档可扫读,并以 Progressive Improvement 章节收尾。该章节要求:当开发者纠正了本技能本应防止的行为时,应建议对本技能做具体修订,避免同样纠正再次发生。

限制:本次资料未提供收费、价格、平台支持范围或实际运行效果等信息。