mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
033adc3768
核查 OpenClaw 时发现 docs/README.openclaw.md 链的是
github.com/anthropics/openclaw —— **那个仓库不存在（404）**，真正的是
openclaw/openclaw。顺手全仓扫了一遍外链，45 条里 4 条是死的。
## 修掉的 4 条
| 原链接 | 状态 | 改为 |
|---|---|---|
| github.com/anthropics/openclaw | 404，仓库不存在 | github.com/openclaw/openclaw |
| github.com/anthropics/antigravity | 404，且 Antigravity 是**谷歌**的产品不是 Anthropic 的 | antigravity.google |
| huaweicloud.com/product/codeartsdoer.html | 404，产品页改版 | codearts.huaweicloud.com |
| docs.codeium.com/windsurf | Windsurf 已从 codeium.com 迁走 | docs.windsurf.com/... |
前两条是**编造出来的出处**。这比没有出处更坏：它让人以为核实过了。
## OpenClaw 本身：路径是对的
顺带核实完了。docs.openclaw.ai/tools/skills 确认 `<workspace>/skills` 为最高
优先级、`~/.openclaw/skills` 为全局，自动发现无需配置，与我们装的一致。
## 固化成检查（verify-release H 段）
编造链接不该靠人肉发现。新增外链验活，两遍制：
- 第一遍 xargs -P 10 并行快扫，只产出「嫌疑名单」，**不下结论**
- 第二遍对嫌疑名单串行复核，放宽到 25s 并让 curl 自己重试；两遍都判死才算死
两遍制不是过度设计 —— 第一版单遍串行把整个脚本拖到超时跑挂了；改并行后又实测
到 docs.codeium.com 在 8s 上限下偶发超时、误报成死链。**一个会误报的门禁比没有
门禁更糟：人会学会忽略它。** 连跑 3 次确认稳定，全绿。
无网络时整段跳过，不阻塞离线发版。
顺带修了个 bash 坑：`bad "死链（$code）: $u"` 里全角括号会被当成变量名的一部分，
报 `code�: unbound variable`。改用 ${code} 花括号界定。
双向验证：塞一条 github.com/anthropics/this-repo-does-not-exist 会被抓出并 FAIL，
移除后恢复全绿。
verify-release 108 -> 109 pass；audit 166 pass / 0 warn / 0 fail。
50 lines
1.8 KiB
Markdown
50 lines
1.8 KiB
Markdown
# 华为云码道 CodeArts 使用指南
|
||
|
||
[华为云码道 CodeArts（CodeArts Doer / Snap）](https://codearts.huaweicloud.com/)是华为云出品的 AI 编程助手，支持 CLI、客户端以及 IntelliJ IDEA / VS Code 插件形态。skills 存放在项目的 `.codeartsdoer/skills/` 目录下。
|
||
|
||
## 一键安装（推荐）
|
||
|
||
在你的项目根目录运行：
|
||
|
||
```bash
|
||
npx superpowers-zh
|
||
```
|
||
|
||
自动检测到 `.codeartsdoer/` 时会安装到 CodeArts。检测不到时显式指定：
|
||
|
||
```bash
|
||
npx superpowers-zh --tool codearts
|
||
```
|
||
|
||
安装内容：
|
||
|
||
- `.codeartsdoer/skills/` — 20 个 skill（每个含 `SKILL.md` 及其 `scripts/` 等附属文件）
|
||
|
||
## Skill 加载优先级
|
||
|
||
| 位置 | 说明 |
|
||
|------|------|
|
||
| `.codeartsdoer/skills/` | 项目级，仅当前项目 |
|
||
|
||
## ⚠️ 关于自动触发
|
||
|
||
本适配为 **skills-only**：把 skills 放到 `.codeartsdoer/skills/`，依赖 CodeArts 自身的 skill 发现机制加载。
|
||
|
||
- 如果 CodeArts 会自动扫描并按需触发 `.codeartsdoer/skills/` 下的 skill，则装完重启即可生效。
|
||
- 如果发现**不会自动触发**，可以在对话里**手动点名** skill（例如「用 brainstorming skill 做需求分析」），skill 内容依然可用。
|
||
|
||
> CodeArts 的 bootstrap / 指令文件约定（类似 `CLAUDE.md` 的自动引导文件）我们尚未验证。如果你是 CodeArts 用户、了解它读取哪个指令文件来自动加载规则，欢迎在 [issue #20](https://github.com/jnMetaCode/superpowers-zh/issues/20) 反馈，我们会补上自动触发的 bootstrap 生成。
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
npx superpowers-zh --uninstall
|
||
```
|
||
|
||
移除 `.codeartsdoer/skills/` 下由 superpowers-zh 安装的 skill 目录。
|
||
|
||
## 反馈
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- 项目主页：https://github.com/jnMetaCode/superpowers-zh
|