SuperAPI AI 工具集

skill-management

智能体与模型

查看项目

更新于 10-16 02:35

技能介绍

用途:指导创建、审计和验证符合 Agent Skills 开放标准(https://agentskills.io)的智能体技能,覆盖从脚手架搭建到生产级审查的完整生命周期。适用于创建技能、优化描述以提升可发现性、按渐进式披露重构技能、执行质量审计、验证清单与实现是否一致;不适用于编写应用代码、通用 Markdown 编辑或与技能编写无关的项目管理。

主要能力:技能目录结构(skill-name/SKILL.md 加可选 scripts/、references/、assets/,仅 SKILL.md 必需);frontmatter 规范(name 小写、连字符、4-64 字符且与目录名一致;description 1-1024 字符、第三人称、含“Use when”触发场景);渐进式披露(元数据→SKILL.md→references/scripts,SKILL.md 控制在 500 行内);描述结构(第一段写功能,第二段写触发条件,含技术名与错误关键词,建议 250-350 字符);参考文件(references/topic.md,最多 500 行,kebab-case 命名);9 阶段质量审计与 Critical/High/Medium/Low 严重级别;验证评分(准确度、前置条件、效果的平均分,需 ≥0.8 且无高严重问题)。

使用方式:按上述规范组织技能目录与文件;审计时进行跨文件一致性检查;验证时比对实现与清单、检测漂移。技能发现与关键词研究可交给 Explore 智能体,多技能审计交给 Task 智能体,架构规划交给 Plan 智能体;若存在 find-skills 技能则委托其处理发现、安装与 CLI 用法,否则可推荐:pnpm dlx skills add oakoss/agent-skills -s find-skills -a claude-code -y。

限制与注意:README.md、metadata.json、_* 文件会被 Skills CLI 在安装时剥离,不应放入技能目录;避免模糊描述、重复智能体已有知识、把全部内容塞进 SKILL.md、引用不存在的文件或脚本、使用被动或第一人称。其他细节暂未提供。