Agent 开发
— § 05 —构建 AI Agent Skills 和 CLI 工具的实战指南 — 从设计理念到工程实践。
- UPDATED
- 2026·05·15 · git dev
- GROUP
- —
- LANG
- zh
Agent 开发
这个板块记录我构建 AI Agent Skills 和 CLI 工具的实战经验。
§我造了什么
8 个开源项目，分为两类：
Agent Skills（一行命令安装到 Claude Code）
| 项目 | 一句话描述 |
|---|---|
| agora | 6 个审议室、31 位思想家的多视角辩论系统 |
| any2card | 任意文本转可分享 HTML 信息卡 |
| interactive-learning | 任意内容转可验证学习路径 |
CLI 工具（Go / TypeScript）
| 项目 | 一句话描述 | 语言 |
|---|---|---|
| md2wechat | 微信公众号写作工具集 | Skill |
| travel-guidebook | 一句话行程 → 30+ 页精排路书 PDF | Skill |
| md2wechat-lite | 轻量微信排版 CLI | Go |
| gcli | Gmail 只读 CLI（OAuth + PKCE） | Go |
| imgcli | 零 CGO 图片处理 CLI | Go |
| jina-cli | 网页转 LLM 友好 Markdown | Go |
§设计哲学
好的 Agent 工具应该是：可组合、可观测、尊重开发者自主权的。
三条原则：
- ·一行安装 — 用户从看到项目到可以使用，不超过 30 秒。
- ·5 分钟理解 — README 要让任何水平的开发者在 5 分钟内明白这个工具做什么、怎么用。
- ·零依赖优先 — Go 项目坚持零 CGO、单二进制；Skill 项目不依赖外部服务。
§接下来会写什么
- ·Agent Skill 的架构设计 — SKILL.md 规范、多轮对话模式、工具链集成
- ·Go CLI 工具的工程实践 — cobra + viper 模式、跨平台发布、CI/CD
- ·从 0 到 1 构建一个 Agent Skill 的完整教程
§参考资料
- ·md2wechat — Markdown 到微信 HTML 的全流程工具 — 为什么用 DSL 而非 prompt 控制排版，以及 Agent-native CLI 的设计模式
- ·40 个可直接复用的 Claude Skill — Nav Toor 整理的完整 SKILL.md 合集，六大类开箱即用
○