SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-15 22:17

技能介绍

用途:Skill Creator 用于创建和打磨 OpenCode 技能,以专门知识与工作流扩展智能体能力,覆盖目录脚手架、SKILL.md 编写、frontmatter 优化和资源组织。

主要能力:技能可提供专门工作流(多步骤流程)、工具集成(文件格式、API、库说明)、领域知识(公司特定知识、schema、业务逻辑)以及可复用脚本、参考文档和资产。技能位置分项目级 .opencode/skill/<name>/SKILL.md 与全局级 ~/.config/opencode/skill/<name>/SKILL.md;项目路径会从 cwd 向上查找到 git worktree 根。

结构:skill-name/ 下含必需的 SKILL.md,以及可选的 scripts/、references/、assets/。SKILL.md 由 frontmatter 与 markdown 正文组成。name 为小写连字符格式、须与目录名一致、最长 64 字符;description 是主要触发机制,须自包含,包含能力、"Use proactively when" 触发场景和 3-5 个具体示例。多行 description 必须用 |- 字面块标量,避免 YAML 解析错误。技能是 SOP/工作流,不是智能体,不要写 "You are a..." 之类角色描述。

使用方式:先理解具体使用示例,再规划可复用资源,然后手动创建目录与 SKILL.md,编写 frontmatter 与正文并添加资源,最后验证加载与触发并迭代。创建命令示例:mkdir -p ~/.config/opencode/skill/my-skill 或 mkdir -p .opencode/skill/my-skill。正文用祈使句、要点列表,脚本须先测试。技能直接从目录使用,无需打包或安装。

适用场景:需要为 OpenCode 智能体补充专门流程、工具用法或领域知识时。限制:SKILL.md 建议不超过 500 行;不得包含 README.md、CHANGELOG.md、INSTALLATION_GUIDE.md 等辅助文档;description 含糊会导致技能不被使用。可通过 agent 配置的 permission.skill 控制访问,取值 allow、deny、ask,支持 * 通配。本技能还附带 references/output-patterns.md 与 references/workflows.md,按需加载。其他细节暂未提供。