⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

agent-design-patterns

@kuhung⭐ 10 stars

运用《智能体设计模式》(Antonio Gulli) 的 21 个模式,指导 AI Agent 系统的架构设计与选型。适用于用户在设计 Agent 工作流(选择链式/路由/并行/多Agent编排)、提升 Agent 输出质量与可靠性(反思/异常处理/Guardrails)、做 RAG 技术选型(混合检索/GraphRAG/Agentic RAG)、优化 Agent 成本与延迟(动态模型切换/回退)时使用。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 10 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

book-skills

「读过的书不该只躺着。它应该在你需要的时候自己跑起来。」

License: MIT | 跨 Agent 通用 Skill

把你的微信读书划线,编译成 AI Agent 可执行的工作方法。

微信读书里有你划过的几百条金句、写过的无数想法。但在真正要用的时候——高压会议、关键邮件、辅导下属——大脑一片空白。明明读过相关的书,就是调不出来。

本仓库做的事:把微信读书里的划线与想法,编译成 SKILL.md 技能指令,一次挂载,Claude Code / Cursor / Codex / Gemini CLI 四家通用。当你的对话匹配某个技能的触发条件时,AI 自动加载那本书的方法论来指导你。

它给你的 AI 装上一副外挂:你读过的书,在你需要时自己开口。

把读书笔记编译成 AI 外挂:沉睡的划线经 book-to-skill 五步流水线编译成 SKILL.md,在对话中被任意 AI Agent 自动调用


看效果

同一个问题:「帮我准备明天和下属的 1:1,他最近状态不好。」

没挂载技能时: AI 给你一个通用模板——开场寒暄、了解进展、给建议、结束。正确但无用。

挂载 coaching-grow 技能后(来自《高绩效教练》):

AI 给出对话脚本:
- 开场设定意图: "这次想聊聊你最近的状态,你希望聊完有什么收获?"
- 现状用描述性问题: "最近哪些事消耗你最多?到目前为止你试过什么?"
- 注意肢体语言与措辞的落差
- 不急于给方案,先问"你觉得有哪些选择?"
- 收尾落到他自己选择的一小步行动

差距:没技能时给的是模板,有技能时给的是基于《高绩效教练》GROW 模型的专业教练式对话策略。 AI 知道"建议交换责任"所以不急着给答案,知道"为什么"改为"是什么原因"更安全,知道先让对方自评再补充观察。

AI 怎么知道该用哪本书?你不用手动指定——正常提问,Agent 用每个技能 description 里的触发场景做路由匹配,命中后按需分层加载,绝不挤占上下文:

使用方法:你正常对话,Agent 用 description 路由键匹配触发场景,命中后加载 SKILL.md 正文;渐进式披露分 L0 description、L1 SKILL.md 正文、L2 notes 深层论据三层按需加载


已挂载的技能

26 个技能,为作者的阅读记录提取,按使用场景分六类。书名可点进对应的 SKILL.md。

🧭 带团队 · 管理下属

书名解决什么问题触发话术
《高绩效教练》用 GROW 提问辅导他人"帮我准备和下属的 1:1"
《关键跨越(新手篇)》从业务高手转型管理者"该自己做还是交给下属"
《关键冲突》问责对话与承诺追踪"下属总是说到做不到怎么办"
《大厂人才》人才盘点与大厂工具祛魅"我们要不要上 OKR"
《效率脑科学》SCARF 模型与前额皮质工作法"团队会议总是低效怎么改"

🏛 组织 · 战略

书名解决什么问题触发话术
《高效能团队模式》逆康威定律设计工程组织"我们团队该怎么拆"
《凤凰项目》+《独角兽项目》DevOps 三步工作法与五大理念"我们的交付流程哪里有瓶颈"
《奈飞文化手册》+《不拘一格》自由与责任的高密度人才文化"我们要不要学奈飞去管控"
《从优秀到卓越》飞轮模型与刺猬理念诊断企业跃迁"我们公司怎么从优秀到卓越"
《战略历程》十大学派透镜审视战略"帮我评审这份战略规划"

💬 销售 · 说服 · 激励

书名解决什么问题触发话术
《说服的艺术》谈判/路演/销售中掌控框架"帮我准备 pitch"
《销售巨人》SPIN 提问推进大订单销售"帮我准备大客户拜访"
《混合信号》激励机制与信号设计"帮我设计考核方案"

🚀 产品 · 增长 · 技术

书名解决什么问题触发话术
《创造》产品从 0 到 1 的关键判断"这个想法值不值得做"
《硅谷增长黑客实战笔记》北极星指标与增长实验"帮我定个北极星指标"
《奔跑吧,程序员》创业期产品、技术与团队决策"这个技术选型该怎么做"
《智能体设计模式》Agent 架构选型"该用什么编排模式"
《用数据讲故事》数据可视化与商业叙事"图表做了但老板看不懂"
《声纹技术》声纹识别系统设计与工程落地"声纹验证系统该怎么选型"

🎯 个人成长 · 效能

书名解决什么问题触发话术
《深度工作》注意力管理与深度工作系统"我总是被打断没法专注"
《掌控习惯》+《福格行为模型》行为设计与习惯养成"我想养成一个习惯"
《单干》一人公司商业决策"专业能力怎么产品化"
《如何避免孤独终老》+《寻找你的维他命人》关系决策框架与维他命人识别"为什么我总遇到同类型的人"

📈 投资 · 交易

书名解决什么问题触发话术
《动量策略》量化交易模型设计与回测"设计一个动量因子方案"
《麦克米伦谈期权》期权策略矩阵与波动率交易"该用什么期权策略保护持仓"
《投资组合再平衡》+《主动投资组合管理》再平衡Alpha分解与信息率评估"这个组合该怎么再平衡"

每个技能都有完整的理论笔记(notes/)和可执行指令(skills/),书名即可点进查看。

为什么 130+ 本只成了 26 个技能? 决定一本书能不能成技能的,是它有没有一套能照着做的方法,跟你划了多少条线关系不大。

数据漏斗:藏书 356 本 → 有个人划线 131 本 → 方法论候选约 24 本 → 已成技能 26 个,决定能否成技能的是方法论密度,跟划线数量关系不大

这 131 本都过了硬门槛——只要在微信读书里划过线就算,哪怕一条想法都没写。往下再筛的是方法论密度:GROW、SPIN、飞轮、DevOps 三步法这类能照着做的框架,才编译得成技能。叙事、历史、传记、科普、备考这些,划线再精彩也压不成一套动作,我把它们留在了外面,跟数据够不够无关。


装上就能用

前置依赖:先装官方 weread skill(weread.qq.com/r/weread-skills),按页面指引拿到 API Key。

然后 clone 本仓库,跑一条命令:

git clone https://github.com/kuhung/book-skills.git
cd book-skills
./install.sh

完成。26 个技能已软链接挂载到你的 Claude Code / Cursor / Codex / Gemini CLI。

添加新书——挂载流水线技能,告诉 AI 要处理哪本:

@skills/book-to-skill/SKILL.md 帮我把《书名》的微信读书笔记转化成技能

流水线自动跑完五步:存档原始划线 -> 结构化重组 -> 提取 Skill -> 更新 README -> 软链接分发。


五步流水线

五步流水线:微信读书 API 的个人划线与社区热门划线,经私有存档、结构化重组、提取技能、README 映射、多 Agent 分发,private 目录被 gitignore 隔离

步骤做什么产出
Step 1微信读书原始划线 -> private/(gitignore 隔离)不可篡改的原始备份
Step 2个人划线 + 社区热门划线重组为逻辑主题notes/书名_笔记.md
Step 3从笔记中提取可落地的方法论框架skills/技能名/SKILL.md
Step 4更新 README 技能注册表README.md 新增条目
Step 5install.sh 软链接到四家 Agent全局可用

核心设计是残差思维——社区热门划线是共识基线,你的个人划线是独特补充,两者合并才是"你对这本书的完整理解"。

残差思维:社区共识(基线)加上你的个人划线与想法(残差),等于你对这本书的完整理解;个人补充只作呈现不作评判,实战修正回写 Field Notes 是第二次残差

详细 SOP 见 skills/book-to-skill/SKILL.md。


一次编译,处处运行

一次编译处处运行:skills 目录是唯一事实源,install.sh 用软链接分发到 Claude Code、Codex、Cursor、Gemini CLI 及项目级挂载点并生成 AGENTS.md,实战修正经软链接直接写回事实源

skills/ 目录是唯一事实源。install.sh 把每个技能软链接到四家 Agent 的标准读取路径:

Agent挂载点机制
Codex / Cursor / Gemini CLI~/.agents/skills/软链接,三者均原生读取 SKILL.md
Claude Code~/.claude/skills/软链接(Cursor 兼容读取)
本仓库项目级.agents/skills、.claude/skills指向 skills/
AGENTS.md根目录生成的技能索引

不要手工拷贝——拷出来的副本迟早跟源头对不上。反馈回路也走软链接:技能在实战中被修正时,无论你身处哪个项目、用哪家 Agent,让它追加到 Field Notes 章节,改动直接落回本仓库。


Fork 后快速开始

想用你自己的微信读书数据编译 AI 技能?

  1. Fork 本仓库
  2. 配置 weread skill 的 API Key
  3. 挂载流水线:@skills/book-to-skill/SKILL.md 帮我把《书名》的微信读书笔记转化成技能
  4. 分发:./install.sh
  5. 日常使用:正常对话,匹配时自动触发

格式模板在 templates/,现有的 27 个 notes 和 26 个 skills 是实际参照。从你最常用的一本书开始。


项目结构

book-skills/
  private/        # 原始划线存档(已 gitignore,绝不公开)
  notes/          # 结构化读书笔记(公开)
  skills/         # 可执行 AI Agent 技能(公开,唯一事实源)
    book-to-skill/  # 流水线 SOP 本身
  templates/      # 格式模板(Skill / 笔记 / 私有存档)
  install.sh      # 一键分发脚本
  AGENTS.md       # 生成的技能索引
  README.md       # 本文件

隐私

  • private/ 已 gitignore,原始划线绝不进公开仓库
  • API Key 不入仓库
  • notes/ 是脱敏后的结构化重组,只保留提炼过的结构,不搬运原书正文

License

构建方法:MIT


关键词: 微信读书 · 微信读书笔记导出 · 读书笔记 · Agent Skills · SKILL.md · Claude Code · Cursor · Codex · Gemini CLI · 知识管理 · 第二大脑 · AI Agent · 划线与想法

作者: kuhung | [email protected]

// HOW IT'S BUILT

KEY FILES

skills/agent-design-patterns/SKILL.mdREADME.md

// REPO STATS

10 stars