Starchild 官方套件
将以下提示词粘贴到你的 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 封成单一目录一技能的技能作者