SuperAPI AI 工具集

dym-scientific-agent-skills-dong-gop-them-sua-skill

编程与开发

查看项目

更新于 10-18 01:22

技能介绍

用途

该技能面向“贡献者轨道”,即克隆科学智能体技能仓库并直接新增或修改技能的人。如果只是想使用仓库中的技能,资料明确建议返回另一篇文档。其核心目标是帮助贡献者按正确顺序准备变更,避免 PR 因形式问题被 CI 拒绝,尤其是仓库中存在一些 CI 硬性拦截、而 validator 报错难以理解的隐性规则,其中 strictyaml 规则尤为突出。

主要能力

  • 判断一个技能是否应放入该仓库:列出会被常规拒绝的类型,包括通用软件工程/代码判断技能、给通用基础设施附加科学示例的技能、宽泛的 orchestrator 技能、已有技能服务的第二个 provider;并说明在范围内的技能是面向某个研究包、数据库、平台或工作流的窄技能,如 scanpy、depmap、benchling-integration、experimental-design。
  • 规定目录布局:plugin.json 位于仓库根;skills/<skill-name>/ 下必须包含 SKILL.md,可选 references/、scripts/、assets/;测试不得放在 skills/ 下,需放在 tests/<skill-name>/;图表放在 docs/images/<skill-name>.png。
  • 规定 frontmatter 只能有 6 个顶层字段:name、description、license、compatibility、allowed-tools、metadata;其余信息全部放入 metadata。
  • 解释三个会导致技能“消失”的 YAML 陷阱:禁止 JSON flow style;metadata 中看起来像数字/布尔/日期的标量必须加引号;metadata.openclaw 与 metadata.hermes 必须保持嵌套映射而非 JSON 字符串。
  • 提供 SKILL.md 模板与正文规则:正文少于 500 行,长文档放 references/;写清工作流、可运行命令与示例;说明依赖、凭证与网络需求;脆弱或重复逻辑放进 scripts/;禁止 secret、私有 URL 和未公开数据;文件引用使用相对路径且最多一层深度。
  • 规定版本管理:新技能从 1.0 开始;修改已有技能需在同一 PR 中 bump,一般改进用 minor,破坏性变更用 major;集合版本变化时 plugin.json 与 pyproject.toml 必须一致。
  • 规定带 scripts/ 的技能必须附带三项:tests/<name>/test_scripts.py 及 fixtures、tests/skill-requirements.toml 中的 [skills.<name>] 条目、必要时指定 python 版本;包完全无法安装时写入 [unavailable] 并说明原因。
  • 规定修改 skills/ 后还需同步 docs/skills.md、docs/examples.md,必要时更新 README.md。
  • 提供提交 PR 前的检查清单,包括目录名与 name 一致、skills/ 下无测试、仅 6 个顶层字段、metadata.version 存在且被引号包裹并已 bump、metadata 为 block mapping、openclaw/hermes 为嵌套映射、uv run skills-ref validate 通过、pytest tests/_meta 通过、带 scripts 的技能还需 tests/run_all.py --isolated 通过、图表标签正确、示例与脚本已测试、无 secret 等。

使用方式

按资料所述,使用者应逐节遵循文档中的顺序:先判断技能是否属于仓库范围,再按布局创建 skills/<name>/SKILL.md,严格按 6 字段编写 frontmatter,注意 YAML 写法,然后按模板撰写正文。若技能含 scripts/,同步创建测试与 requirements 条目。修改完成后更新相关文档,最后逐项执行检查清单中的命令:uv run skills-ref validate skills/<name>、uv run --with pytest python -m pytest tests/_meta -q,以及带 scripts 时的 python tests/run_all.py --isolated <name>。

适用场景

适用于准备向该科学智能体技能仓库提交新增技能或修改现有技能的贡献者,尤其是需要理解 CI 与 validator 隐性规则、避免 PR 因格式问题被拒的场景。

限制与注意事项

资料明确指出该技能不适用于仅使用技能的用户。技能以越南语撰写。文档中提到的 scripts/generate_skill_image.py 在仓库中并不存在,尽管 AGENTS.md 有相关说明,但 .gitignore 导致该目录从未被提交,图表生成命令不可依赖。32 个技能共享 scripts/_common.py,顶层模块命名需注意单技能单进程规则。docx、pdf、pptx、xlsx 四个文档技能来自 Anthropic,属于 vendored 上游跟踪,修改它们属于逆流操作,且 tests/_meta 会在字节级副本漂移时报告失败。关于收费、平台支持等事实,资料暂未提供。