mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-09-05 21:23:57 +08:00
## 背景 / Background 市场里 25 个 pointer 条目中有 **14 个点安装必然失败**,客户端返回 502「源仓库中未找到 SKILL.md(pointer 指向有误)」。 根因是 `entry.json` 的 `source` 指错:客户端按 `source.path` 定位内容(缺省则取仓库根),而这些条目的 `path` 缺失或 URL 指向了 HTML 页面,`contentDir/SKILL.md` 自然不存在。 Of the 25 pointer entries, **14 always failed to install** with a 502. The `source` pointers were wrong: `path` was missing (so the client looked at the repo root) or `repoUrl` pointed at an HTML page instead of the content. ## 改动 / Changes ### 1. 补 `source.path`(5 个) | 条目 | path | 上游 SKILL.md 实际位置 | |---|---|---| | `impeccable` | `plugin/skills/impeccable` | 根目录没有;`plugin/` 与 `.claude/` 两份内容逐字节一致,取中立的分发目录 | | `ai-news-radar` | `skills/ai-news-radar` | 仓库另有 `skills/radar`,取与条目 id 对应的 | | `taste-skill` | `skills/taste-skill` | 同名子目录 | | `wechatpay-skills` | `wechatpay-payment-integration` | 仓库另有 `wechatpay-product-coupon` 未覆盖,见下方遗留项 | | `luckin-my-coffee` | `my-coffee` | zip 内有一层顶层目录 | ### 2. 修正 web 类条目的源地址(2 个) `amap-jsapi-skill` / `dingtalk-api` 原先指向 ClawHub 的**网页**(`content-type: text/html`),客户端只在 markdown 时才写成 `SKILL.md`,HTML 会落成 `index.html`,校验必失败。 - `amap-jsapi-skill` → 改用 ClawHub 文件 API(返回 `text/markdown`)。该技能在 ClawHub 的发布包 `version.files` 只有一个 `SKILL.md`,单文件抓取正是对的形态。 - `dingtalk-api` → ClawHub 包有 38 个文件(`scripts/*.ts` 等),单文件抓不全,改指内容完整的 GitHub 上游 `ogenes/dingtalk-api` 并锁 ref。 ### 3. 合集条目声明 `children`(7 个,147 个子技能) 这 7 个的上游是「一个仓库装着 N 个平级技能」,没有单一 SKILL.md 可指,靠改 `path` 修不了。配合客户端新增的合集能力(desirecore 主仓库 PR),`entry.json` 现在可声明子技能清单,市场仍是一个条目,安装时由用户勾选装哪几个。 | 条目 | 子技能数 | |---|---| | `marketingskills` | 49 | | `mattpocock-skills` | 35 | | `larksuite-cli` | 27 | | `baoyu-skills` | 21 | | `wecom-cli` | 7 | | `khazix-skills` | 5 | | `netease-skills` | 3 | 新增 `scripts/gen-collection-children.py`:按 `entry.json` 锁定的 ref 克隆上游、扫描子技能、读 frontmatter 生成 `children`。约定「仓库有顶层 `skills/` 就只扫它」——否则会收录 `larksuite/cli` 的 linter 测试夹具 `internal/qualitygate/skillscan/testdata/skills/lark-demo`。 ### 4. `netease-skills` 分支修正 `repoBranch` 写的是 `main`,上游默认分支是 `master`,此前 clone 必然失败(`Could not find main`)。 ### 5. 版本号 `manifest.json` `1.2.24` → `1.2.25`。 ## 验证 / Verification - `uv run scripts/i18n/validate-i18n.py` — OK - `uv run scripts/i18n/validate-i18n.py --online` — OK - **真实运行的 agent-service 上逐个安装**(独立 home + standalone 服务,非模拟):18 个非合集 pointer 条目 **18/18 成功**并完整落盘;7 个合集条目 **7/7 成功**,并验证了部分安装、追加、取消勾选卸载、装到 Agent 私有目录。 ## 遗留项 / Known gaps - `wechatpay-skills` 只覆盖了 `wechatpay-payment-integration`,同仓库的 `wechatpay-product-coupon` 未上架。条目名是复数,后续可拆成两条或改成合集。 - `children[].i18n` 目前只有 `shortDesc`(取自上游 description),**没有中文名**——子技能名沿用上游 id(如 `lark-approval`),以保证与上游文档、Agent 加载路径一致。宝玉 / Matt Pocock / Marketing 三个合集的描述本身就是英文。如需中文化,可接 `i18n-translate.yml` 覆盖 `children` 字段。 - 在线校验目前只查 URL 可达性,**查不出 `path` 指向的目录里有没有 SKILL.md**——这 14 个坏条目当初就是这么一路绿灯合进主干的。建议后续给 `--online` 加这条断言。 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: xieyuanxiang <xieyuanxiang123@gmail.com>
33 lines
1.4 KiB
JSON
33 lines
1.4 KiB
JSON
{
|
||
"id": "amap-jsapi-skill",
|
||
"name": "AMap JSAPI Skill",
|
||
"category": "development",
|
||
"icon": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"m4 6 5-2 6 2 5-2v14l-5 2-6-2-5 2V6Z\" stroke=\"#2563EB\" stroke-width=\"1.7\" stroke-linejoin=\"round\"/><path d=\"M9 4v14m6-12v14\" stroke=\"#2563EB\" stroke-width=\"1.7\"/><path d=\"M12 8.25c-1.24 0-2.25.9-2.25 2.03 0 1.52 2.25 3.47 2.25 3.47s2.25-1.95 2.25-3.47C14.25 9.15 13.24 8.25 12 8.25Z\" fill=\"#2563EB\"/></svg>",
|
||
"tags": [
|
||
"lbs-amap"
|
||
],
|
||
"i18n": {
|
||
"zh-CN": {
|
||
"name": "高德地图 JSAPI 技能",
|
||
"shortDesc": "高德地图 JSAPI v2.0(WebGL)开发技能,涵盖地图生命周期、安全配置、3D 视图、覆盖物绘制与 LBS 服务集成"
|
||
},
|
||
"en-US": {
|
||
"name": "AMap JSAPI Skill",
|
||
"shortDesc": "AMap JSAPI v2.0 (WebGL) development skill covering map lifecycle, security config, 3D views, overlays and LBS services"
|
||
}
|
||
},
|
||
"maintainer": {
|
||
"name": "lbs-amap",
|
||
"verified": false,
|
||
"account": "lbs-amap",
|
||
"url": "https://clawhub.ai/lbs-amap/skills/amap-jsapi-skill"
|
||
},
|
||
"stewardship": "community",
|
||
"license": "MIT-0",
|
||
"redistribution": "allowed",
|
||
"source": {
|
||
"kind": "web",
|
||
"repoUrl": "https://clawhub.ai/api/v1/skills/amap-jsapi-skill/file?path=SKILL.md&ownerHandle=lbs-amap"
|
||
}
|
||
}
|