Agent Skills
返回列表
💻

Starchild 官方套件

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/starchild-ai-agent-official-skills。

技能介绍

要解决什么问题

在 Starchild agent 生态里,技能是以独立目录 + SKILL.md 前置元数据的形式分发的;索引文件 skills.json 由 CI 自动生成,不能手改。若你正在新建或维护某个集成技能,往往卡在:元数据缺哪些字段、版本怎么 bump、删技能后用户容器里怎么下线——文档散落在仓库约定与 CONTRIBUTING 里,需要一份可对照的「官方契约」。

技能如何工作

本技能描述的是 Starchild 官方技能仓库的规范与流水线,而非某个具体业务 API。

  • 安装与收录:通过 npx skills add 拉取整个技能目录;仓库要求每个可安装单元对应一个顶层目录,且至少包含 SKILL.md。
  • SKILL.md 契约:YAML frontmatter 必须含 name(小写连字符)、version(semver)、description(检索用一行摘要);可选 tools、metadata(含 starchild.emoji / skillKey)、user-invocable、tags。
  • 开发与发布:新增目录并写好 frontmatter 后推 main,GitHub Actions 校验所有 SKILL.md、从 frontmatter 重建 skills.json 并在变更时自动提交;更新技能需 提高 frontmatter 中的 version,已安装用户下次 npx skills add 会因 computedHash 变化拿到新版本。
  • 移除与约定:删除目录即可从索引去掉;若还要从运行中的用户容器移除,需在 starchild-clawd 的 config/skill-removals.txt 登记技能名。CONTRIBUTING 侧还覆盖 exports.py 模式、按意图拆分函数、logo 与发布清单。

适用边界与注意点

  • 面向 技能作者与维护者,不是终端用户的「点一下就交易/查数据」类技能。
  • skills.json 只读自动生成;命名保持小写连字符、一目录一技能、描述要写清关键词以利于搜索。
  • 多文件技能(Python、模板、配置)与 SKILL.md 同目录即可,npx skills add 会递归复制整目录。

使用场景

  • 第一次在 Starchild 官方仓库新建顶层技能目录,需要确认 frontmatter 必填字段与命名规则
  • 合并前自检:push 后 CI 是否会因缺少 version 或 description 导致 SKILL.md 校验失败
  • 发布小修复后要在 frontmatter 里改 patch 版本,并确认用户侧靠 computedHash 拉取新版本
  • 下线某个集成技能时,除删目录外还要在 starchild-clawd 的 skill-removals.txt 登记

适合人员

  • 负责给 Starchild agent 写 Python 工具导出、需要对照 exports.py 与函数拆分约定的后端工程师
  • 维护官方技能索引、不想手改 skills.json、只通过 frontmatter 驱动发布的仓库维护者
  • 为多文件技能(脚本+模板)规划目录结构、确保 npx skills add 能整包复制的集成开发者
  • 写 CONTRIBUTING 清单里的 logo 与发布项、准备把第三方 API 封成单一目录一技能的技能作者