SuperAPI AI 工具集

add-community-extension

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:处理 GitHub 上的扩展提交 Issue,将社区扩展新增或更新到 Spec Kit 目录。

适用时机:出现新的 [Extension] 提交 Issue,或既有扩展提交更新 Issue(新版本、元数据变更)。

主要能力与流程:

  1. 读取 Issue,提取扩展 ID、名称、版本、描述、作者、仓库与下载地址、主页、文档、变更日志、许可证、所需 spec-kit 版本、可选工具依赖、命令与钩子数量、标签。
  2. 按 extensions/EXTENSION-PUBLISHING-GUIDE.md 校验:仓库公开且存在、extension.yml 清单、README.md、LICENSE 文件、对应版本的 GitHub Release、下载地址符合 archive/refs/tags/vX.Y.Z.zip 模式、扩展 ID 仅小写与连字符(^[a-z][a-z0-9-]*$)、版本遵循 semver(X.Y.Z)、Issue 检查项全部勾选。
  3. 在 extensions/catalog.community.json 中查找 ID,决定是新增还是就地更新。
  4. 新增按 ID 字母序插入;更新则就地替换,只改变化字段,保留 created_at、downloads、stars,并刷新目录顶层 updated_at。字段含 name、id、description、author、version、download_url、repository、homepage、documentation、changelog、license、category、effect、requires、provides、tags、verified、downloads、stars、created_at、updated_at。category 为自由字符串(常见 docs、code、process、integration、visibility);effect 取 read-only 或 read-write。可选工具依赖放入 requires 的 tools 数组。
  5. 编辑后校验 JSON:python3 -c "import json; json.load(open('extensions/catalog.community.json')); print('Valid JSON')"。
  6. 更新 docs/community/extensions.md 的社区扩展表,按名称字母序增行或就地更新,格式为 | <Name> | <Description> | <category> | <Effect> | <repo-name> |,表中显示用 Read-only/Read+Write。
  7. 建分支 add-<extension-id>-extension 或 update-<extension-id>-extension,提交并推送,向上游 github/spec-kit 开 PR,标题注明新增或更新,正文含校验摘要并以 Closes #<issue-number> 关联 Issue。

限制与常见问题:条目必须保持字母序;勿忘刷新 updated_at;JSON 需校验;使用 Closes 而非 Fixes;Issue 中给出的 JSON 提案仍需对照仓库实际状态核验;更新时不得重置 created_at、downloads、stars。