HiClaw 多了个Worker 市场:186 个模板,我找到了什么?
HiClaw 的 Worker 模板市场在 4 月 17 日刚上线,号称有 186 个 Worker 可以用。作为一个 AI 应用开发者,我第一时间去逛了逛这个"模板超市",结果发现了一些有意思的东西,也踩了不少坑。
今天就把整个过程记录下来,希望能给同样在关注 AI Agent 生态的朋友一些参考。
🏪 走进"模板超市"
打开市场的第一眼,186 个 Worker 铺满屏幕,从学术人类学家到区块链安全审计师,从政府售前顾问到绩效评估专家,覆盖面确实广。

但很快我发现了第一个问题:搜索功能不太好用。
我想找"代码审查"相关的 Worker,试了几个关键词:
|
|
|
|---|---|
code review |
|
代码评审 |
|
git |
|
review |
|
发现 1:市场搜索只匹配英文名称,中文关键词全部返回 0。这对接手的用户不太友好。
🎯 第一个目标:代码审查 Worker
用 review 终于找到了目标 —— engineering-code-reviewer(代码审查员)。
点进去一看,配置还不错:
- 三级问题分类
:🔴 阻塞项 / 🟡 建议项 / 💭 小改进 - 按语言区分
:Go 的错误处理、Python 的 N+1 查询、TypeScript 的原型污染 - 审查策略
:大 PR 先看测试、Hotfix 聚焦正确性、新人代码多解释"为什么"
这个 Worker 的核心思路很好:代码审查是教学,不是批判。
但问题来了:怎么部署?
市场给了三种方式:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
发现 2:下载功能有 bug,HTTP 端点返回的是 SPA 页面而非实际文件。
不过没关系,我直接从 GitHub 源仓库拿到了完整配置。这个 Worker 的源文件在 https://github.com/jnMetaCode/agency-agents-zh,是个 7.2k star 的开源项目。
代码审查 Worker 配置已保存,171 行,内容扎实。但因为需要 Git webhook 和 MCP Server 环境,实际测试成本比较高,我先放一放。
📝 换个思路:找个好测试的
代码审查需要 PR 环境,太复杂。我换了个方向:找一个纯文本输入输出、不需要外部服务的 Worker。
搜索 writer,找到了 engineering-technical-writer(技术文档工程师)。
点进去一看,这个 Worker 的质量明显更高:
核心亮点
1. 5 秒测试标准
每个 README 必须让读者在 5 秒内明白三件事:
这是什么? 我为什么要用? 怎么开始?
这三条简单但极其有效。多少开源项目的 README 只回答了第一个问题?
2. Divio 文档体系
把文档分成四类,绝不混在一起:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. 质量门槛极其严格
-
代码示例必须能跑(发布前在干净环境测试过) -
每个新功能上线时必须带文档 -
Breaking change 必须有迁移指南 -
过期文档让 CI 构建失败
4. 成功指标可量化
-
文档上线后相关工单量下降 20% -
新开发者首次成功时间 < 15 分钟 -
文档搜索满意度 >= 80% -
零损坏的代码示例
这个 Worker 的配置有 408 行,比代码审查的 171 行多了一倍多,质量也明显更成熟。
🔧 实践环节:用 Worker 标准重写 README
光看不练假把式。我拿自己的 MCP 工具集项目练手 —— jj-mcp-tools,一个给 AI 助手提供各种能力的工具集。
重写前的 README
原来的 README 长这样:
JJ 的 MCP 服务器工具集,提供文件操作、网页抓取、数据处理、钉钉机器人、GitLab API 和远程 SSH 等功能。
5 秒测试结果:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
核心问题:只有功能列表,没有场景描述。读者看完不知道"这跟我有什么关系"。
重写后的 README
按照 Worker 的"5 秒测试"标准,我做了这些改动:
1. 重写开头
给 AI 助手装上 11 种超能力——文件操作、钉钉通知、公众号发布、生图、SSH 远程,全都能通过 MCP 协议一句话调用。
从"技术描述"变成了"场景描述",读者一眼就能理解价值。
2. 新增"为什么需要这个"
列出了 5 个真实使用场景:
-
发钉钉通知 — 代码部署完成自动推送 -
发布公众号文章 — Markdown 一键转格式 -
生成配图 — 调用通义万相 API -
SSH 远程操作 — 不用切终端 -
读取 GitLab — 查看 commit、比较分支
3. 新增"30 秒快速开始"
30 秒跑通:安装 + 配置第一个工具
选择文件操作作为入门,因为不需要任何 API Key,即时可见效果,能快速建立信心。
4. 工具列表改表格
从段落式变成了命令 + 功能对照表,查阅更方便。
5. 配置说明表格化
环境变量加上了"必需"列,用户一看就知道哪些必须配、哪些可以先跳过,减少"配置焦虑"。
效果对比
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
时间花费:约 15 分钟。
📊 两轮实践总结
Worker 质量评估
|
|
|
|
|
|
|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
关键发现:
- 搜索坑
:只匹配英文名称,中文关键词全部返回 0 - 下载坑
:HTTP 端点返回 HTML 而非文件,需要手动从 GitHub 获取 - 部署坑
:需要登录 Manager Console 手动导入 - 质量差异大
:技术文档 Worker 明显优于代码审查 Worker - 社区冷启动
:186 个 Worker 全部下载量为 0
这个市场值得用吗?
值得,但有门槛。
Worker 模板本身的质量不错,尤其是技术文档工程师这种成熟度高的,直接套用就能显著提升文档质量。
但市场的基础设施还需要完善:搜索、下载、部署流程都有改进空间。目前更适合有一定经验的开发者手动获取和部署,不太适合新手"一键安装"。
💡 给想用的朋友的建议
- 搜索用英文
:别用中文关键词,直接用英文搜索 - 从 GitHub 源获取
: https://github.com/jnMetaCode/agency-agents-zh,7.2k star 的开源项目 - 优先选高频场景
:技术文档、代码审查、项目管理这类 Worker 最实用 - 自己动手改造
:拿到模板后根据自己的项目调整,别照搬
📁 已保存的文件
我把今天实践过程中获取的所有 Worker 配置和测试报告都保存了下来:
hiclaw-workers/
├── engineering-code-reviewer.md # 代码审查 Worker(171 行)
├── engineering-technical-writer.md # 技术文档 Worker(408 行)
├── manifest.json # Worker 元数据
└── test-results/
├── technical-writer-test.md # 测试报告
├── readme-rewrite-report.md # README 重写详细报告
└── article-draft.md # 本文
如果你对某个 Worker 的配置感兴趣,可以直接去 GitHub 仓库查看,或者等 HiClaw 市场修复下载功能后再一键安装。
下一步计划:用技术文档工程师的标准,为 MCP 工具集编写一个"15 分钟从零到跑通"的分步教程,以及 OpenAPI 规范的 API 参考文档。到时候再和大家分享成果。


评论