给 agent 一个”你是架构师”的提示词,它输出泛泛的架构。给它加载 Martin Fowler + Uncle Bob + Google SWE Book 的知识库,它输出具体的、有依据的架构决策。
问题
通用 agent 什么都能做,但什么都做不深。
一个带着”你是产品经理”系统提示词的 agent,写出来的 PRD 是正确的——格式对、字段全、逻辑通顺。但它缺少的是判断力:这个需求该不该做?用户价值公式怎么算?交易模型是否成立?
这些判断力来自领域知识的深度积累,不是通用提示词能给的。
设计
我们的解决方案是给每个 agent 配一套领域专家 skill——不是简单的角色描述,而是结构化的知识库:
skill/├── SKILL.md # 路由规则、输出模板、激活触发条件└── references/ # 深度知识库(按需加载) ├── 01-principles.md # 核心原则 ├── 02-methods.md # 方法论 ├── 03-patterns.md # 模式与反模式 ├── 04-evaluation.md # 评估框架 ├── 05-cases.md # 案例分析 ├── 06-integration.md # 集成指南 ├── 07-pitfalls.md # 常见陷阱 └── 08-advanced.md # 高级话题三个设计原则
关注点分离:每个 agent 只精通一个领域。不试图什么都做。
按需加载:reference 文件只在 skill 激活时加载。平时不占用上下文窗口。
知识融合:每个 skill 融合 2-3 个权威来源,合成一套连贯的方法论。不是教科书搬运——是有观点的、可操作的框架。
8 套 Skill 模板
| Skill | 绑定 Agent | 知识源 | 文件数 |
|---|---|---|---|
| 架构大师 | 芋泥 | Martin Fowler(重构/演进式设计)+ Uncle Bob(SOLID/Clean Architecture)+ Google SWE Book(大规模工程实践) | 9 |
| 全栈大师 | 汤圆、饺子 | Dave Thomas & Andy Hunt(《务实的程序员》)+ Kent Beck(XP/TDD/简单设计)+ Google Style Guides(代码可读性) | 9 |
| 产品大师 | 奶茶 | 俞军(交易模型/用户价值公式)+ Marty Cagan(SVPG/产品发现)+ 张小龙(微信产品哲学) | 9 |
| 视觉设计大师 | 可乐 | Dieter Rams(“Less, but better”/十项原则)+ Don Norman(可供性/映射/反馈)+ 原研哉(“白”/触觉设计) | 9 |
| 测试大师 | 牛奶 | James Bach(探索性测试/Context-Driven)+ Kent Beck(TDD)+ Google Testing(测试金字塔/Beyoncé Rule) | 9 |
| Prompt 大师 | 阿墨 | Anthropic Prompt Engineering + Lilian Weng(Agent 系统设计)+ OpenAI Cookbook(最佳实践) | 9 |
| 公众号运营大师 | 包子 | 粥左罗(爆款方法论)+ 郭静(算法推荐/平台趋势)+ B2B 企业运营体系(SaaS 获客/私域) | 9 |
| 投资大师 | (通用) | 巴菲特投资框架(复利/内在价值/安全边际/能力圈/Mr. Market) | 6 |
总计:78 个参考文件,924KB 结构化知识。
知识融合方法
每个 skill 不是简单地把三本书的内容拼在一起。而是做了融合:
以架构大师为例:
- Martin Fowler 提供了演进式设计的方法论——不要一次性做完架构,让架构随需求生长
- Uncle Bob 提供了组件级的设计原则——SOLID、依赖倒置、组件内聚/耦合
- Google SWE Book 提供了大规模工程的实战经验——代码评审文化、技术债务管理、团队协作
融合后的效果:芋泥做架构决策时,不会只从一个角度思考。它会同时考虑”这个设计符不符合 SOLID”(Uncle Bob)、“这个设计能不能演进”(Fowler)、“这个设计在大团队里能不能维护”(Google SWE)。
SKILL.md 结构
每个 SKILL.md 包含:
# 激活条件以下场景必须触发本 skill:- 分析系统架构- 评估技术方案- 做架构决策- ...
# 思维框架当激活时,融合以下三位大师的核心方法论:1. Martin Fowler — 重构/演进式设计/企业应用架构2. Robert C. Martin — SOLID/Clean Architecture/组件原则3. Google SWE Book — 大规模工程实践/代码评审/技术决策
# 输出模板分析任何架构问题时,输出必须包含:- 问题识别- 多方案对比- 推荐方案及理由- 风险评估- 演进路径
# 参考文件按需加载 references/ 目录下的知识库文件。关键设计:激活条件是语义触发的。不需要用户说”用架构大师 skill”——任何涉及架构分析、技术方案评估、系统设计的话题都自动触发。
效果
加载领域专家 skill 后,agent 输出的核心变化是:从”正确但泛泛”变成”有依据、有判断、有取舍”。
具体表现:
- 引用来源:输出中会引用具体的原则(如 Fowler 的演进式设计、Uncle Bob 的 CCP 原则),而不是泛泛地列优缺点
- 有取舍:会明确说”在当前阶段建议 X 而不是 Y”,并给出具体理由
- 有风险评估:不只推荐方案,还会指出方案的风险和补救措施
这个变化在 8 套 skill 全部上线当天(4/14)就观察到了,是所有改进中见效最快的。
如何为自己的团队构建 Skill
- 确定 agent 的角色边界——一个 agent 精通一个领域
- 选择 2-3 个权威来源——不是越多越好,2-3 个足够形成三角验证
- 融合而非堆砌——把多个来源的思想融合成一套连贯的方法论
- 写激活条件——让 skill 自动触发,不依赖用户记得调用
- 按需加载——reference 文件分 8 个主题,只在需要时加载
统计
- 8 套 skill 模板
- 78 个参考文件
- 924KB 结构化知识
- 每个 skill 融合 2-3 个权威来源
- 覆盖:架构、全栈开发、产品、视觉设计、测试、Prompt 工程、运营、投资