feat(wiki): ingest Cloud DevOps and Home Office sources batch
This commit is contained in:
48
wiki/concepts/AgentSkill设计模式.md
Normal file
48
wiki/concepts/AgentSkill设计模式.md
Normal file
@@ -0,0 +1,48 @@
|
||||
---
|
||||
id: agent-skill-design-pattern
|
||||
title: "AgentSkill设计模式"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: [Google-5个Agent-Skill设计模式.md]
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# AgentSkill设计模式
|
||||
|
||||
将领域知识或工作流有效封装进Skill的五种设计模式,Google与Anthropic经验总结。
|
||||
|
||||
## 五种模式
|
||||
|
||||
| 模式 | 核心机制 | 适用场景 |
|
||||
|------|----------|----------|
|
||||
| [[ToolWrapper]] | 按需动态加载知识文档 | 编码规范、框架最佳实践 |
|
||||
| [[Generator]] | 模板+变量填充生成一致输出 | API文档、报告生成 |
|
||||
| [[Reviewer]] | 检查标准与执行逻辑分离 | 代码审查、安全审计 |
|
||||
| [[Inversion]] | 先问再做,延迟执行 | 需求分析、项目规划 |
|
||||
| [[Pipeline]] | 硬性检查点强制顺序执行 | 复杂流水线、质量控制 |
|
||||
|
||||
## 核心问题
|
||||
|
||||
SKILL.md格式标准化后(已被30+主流工具支持),同等格式的skill执行效果天差地别。差距在于**内容设计**,而非格式。
|
||||
|
||||
## 模式组合
|
||||
|
||||
五种模式并非互斥,可以组合使用:
|
||||
- Pipeline末尾可加Reviewer进行double-check
|
||||
- Generator开始可用Inversion收集必要变量
|
||||
- Reviewer可嵌入Pipeline作为质量关卡
|
||||
|
||||
## 理论基础
|
||||
|
||||
- [[Anthropic]]经验:最好的Skill是「工具箱」,不是大prompt;三条铁律:只写Agent不知道的、重点写踩坑清单、给工具不给指令
|
||||
- [[Google]]ADK:SkillToolset和渐进式披露机制,agent只在运行时需要时才消耗上下文token加载特定模式
|
||||
|
||||
## 与AgenticAI关系
|
||||
|
||||
[[AgenticAI]]的发展使得Skill设计从"写好提示词"转向"设计好工作流结构"。五种模式将[[AgenticAI]]的能力通过结构化Skill封装为可复用模块。
|
||||
|
||||
## 相关概念
|
||||
|
||||
- [[AgentSkill]]:Skill的实例化
|
||||
- [[AgenticAI]]:Agent具备自主行动能力
|
||||
- [[工作流自动化]]:Pipeline模式的技术基础
|
||||
48
wiki/concepts/Generator.md
Normal file
48
wiki/concepts/Generator.md
Normal file
@@ -0,0 +1,48 @@
|
||||
---
|
||||
id: generator
|
||||
title: "Generator"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: []
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# Generator
|
||||
|
||||
通过模板和变量填充流程,从用户需求生成结构化、一致性输出的Skill设计模式。
|
||||
|
||||
## 定义
|
||||
|
||||
Generator模式利用预定义的输出模板和样式指南,由Agent扮演项目经理角色,通过"收集缺失变量→填充模板→输出结果"的流程,保证每次运行生成格式完全一致的文档或代码。
|
||||
|
||||
## 机制
|
||||
|
||||
- assets/目录存放输出模板
|
||||
- references/目录存放样式指南
|
||||
- SKILL.md作为协调器,指导Agent加载模板、读取指南、收集变量、填充内容
|
||||
- 变量未齐全时,Agent主动向用户询问
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 统一API文档生成
|
||||
- 标准化commit信息格式
|
||||
- 项目脚手架初始化
|
||||
- 报告/简报批量生成
|
||||
|
||||
## 优点
|
||||
|
||||
- 输出格式完全一致可预期
|
||||
- 模板与内容分离,便于更新样式
|
||||
- 变量收集机制确保信息完整
|
||||
|
||||
## 缺点
|
||||
|
||||
- 模板维护成本较高
|
||||
- 变量收集可能增加交互轮次
|
||||
- 不适合高度创造性任务
|
||||
|
||||
## 关系
|
||||
|
||||
- 上位概念:[[AgentSkill设计模式]]
|
||||
- 可组合:[[Inversion]](用Inversion收集变量)
|
||||
- 可组合:[[Reviewer]](用Reviewer检查输出)
|
||||
47
wiki/concepts/Inversion.md
Normal file
47
wiki/concepts/Inversion.md
Normal file
@@ -0,0 +1,47 @@
|
||||
---
|
||||
id: inversion
|
||||
title: "Inversion"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: []
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# Inversion
|
||||
|
||||
将Agent工作流从"先做后问"反转为"先问再做"的Skill设计模式。Agent变为面试官,通过阶段性提问收集必要信息后才会开始执行。
|
||||
|
||||
## 定义
|
||||
|
||||
Inversion模式通过硬性门控指令(gate)控制工作流:明确规定"不到所有阶段完成就不开始构建"。Agent逐阶段提问,等待用户回答,确认后才进入下一阶段,最终才执行核心任务。
|
||||
|
||||
## 机制
|
||||
|
||||
- 硬性门控指令:不到所有阶段完成就不开始构建
|
||||
- 阶段化提问:Agent按阶段逐一提问
|
||||
- 等待确认:每个阶段需用户明确回答后才进入下一阶段
|
||||
- 延迟执行:收集完所有必要信息后才执行实际操作
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 项目规划(收集需求、约束、优先级)
|
||||
- 需求分析(功能范围、技术栈、时间线)
|
||||
- 决策咨询(收集选项、偏好、限制条件)
|
||||
- 内容创作(主题、受众、风格偏好)
|
||||
|
||||
## 优点
|
||||
|
||||
- 确保执行前信息完整
|
||||
- 用户参与度高,减少返工
|
||||
- 避免Agent盲目猜测导致浪费
|
||||
|
||||
## 缺点
|
||||
|
||||
- 初始交互轮次多,用户可能不耐烦
|
||||
- 问题设计需要精心规划
|
||||
- 不适合紧急/简单任务
|
||||
|
||||
## 关系
|
||||
|
||||
- 上位概念:[[AgentSkill设计模式]]
|
||||
- 可组合:[[Generator]](用Inversion收集Generator所需的变量)
|
||||
61
wiki/concepts/Pipeline.md
Normal file
61
wiki/concepts/Pipeline.md
Normal file
@@ -0,0 +1,61 @@
|
||||
---
|
||||
id: pipeline
|
||||
title: "Pipeline"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: []
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# Pipeline
|
||||
|
||||
在复杂任务中设置硬性检查点,强制Agent按严格顺序执行工作流的Skill设计模式。
|
||||
|
||||
## 定义
|
||||
|
||||
Pipeline模式通过实现明确的门控条件,确保Agent无法跳过步骤或忽略指令。每个关键节点设置检查点,用户必须在进入下一步之前确认,否则流程不会继续。
|
||||
|
||||
## 机制
|
||||
|
||||
- 工作流步骤明确定义在SKILL.md中
|
||||
- 每步有明确的进入前置条件
|
||||
- 门控条件未满足时阻止进入下一步
|
||||
- 文档流水线示例:解析清点→生成文档字符串→组装文档→质量检查
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 复杂多步骤任务(文档生成流水线)
|
||||
- 需要严格质量控制的流程
|
||||
- 合规/审计要求不能跳过的步骤
|
||||
- 多人协作中需要明确交接点
|
||||
|
||||
## 优点
|
||||
|
||||
- 步骤不会被跳过
|
||||
- 质量控制点明确
|
||||
- 流程可追溯可审计
|
||||
- 减少因跳过步骤导致的错误
|
||||
|
||||
## 缺点
|
||||
|
||||
- 灵活性低,急救场景不适用
|
||||
- 用户可能觉得检查点过多
|
||||
- 流程僵化,难以适应特殊情况
|
||||
|
||||
## 与Inversion对比
|
||||
|
||||
| 维度 | Pipeline | Inversion |
|
||||
|------|----------|-----------|
|
||||
| 方向 | 强制顺序执行 | 先问再做 |
|
||||
| 控制点 | 技术门控(条件判断) | 问答门控(收集信息) |
|
||||
| 适用场景 | 复杂技术流程 | 需求分析决策 |
|
||||
|
||||
## 关系
|
||||
|
||||
- 上位概念:[[AgentSkill设计模式]]
|
||||
- 可组合:[[Reviewer]](Pipeline末尾加Reviewer步骤)
|
||||
- 示例应用:[[文档流水线]]
|
||||
|
||||
## 相关实体
|
||||
|
||||
- [[Google]]:发布Pipeline模式的云服务提供商
|
||||
52
wiki/concepts/Reviewer.md
Normal file
52
wiki/concepts/Reviewer.md
Normal file
@@ -0,0 +1,52 @@
|
||||
---
|
||||
id: reviewer
|
||||
title: "Reviewer"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: []
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# Reviewer
|
||||
|
||||
将"检查什么"(审查标准)与"怎么检查"(执行逻辑)完全分离的Skill设计模式。
|
||||
|
||||
## 定义
|
||||
|
||||
Reviewer模式将审查规则与执行机制解耦:审查标准存放于references/review-checklist.md,可替换为Python风格检查、安全审计、数据质量检查等;执行逻辑保持静态,Agent动态加载对应审查标准并输出结构化结果。
|
||||
|
||||
## 机制
|
||||
|
||||
- references/目录存放可替换的审查清单
|
||||
- SKILL.md定义静态审查指令
|
||||
- Agent动态加载特定审查标准
|
||||
- 输出按严重程度分组的结构化结果
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 代码审查(Python风格、PEP8等)
|
||||
- 安全审计(OWASP Top 10等)
|
||||
- 文档质量检查
|
||||
- 数据质量验证
|
||||
|
||||
## 优点
|
||||
|
||||
- 一套skill基础设施,换清单即换专项
|
||||
- 审查标准独立维护,便于更新
|
||||
- 结构化输出便于后续处理
|
||||
|
||||
## 缺点
|
||||
|
||||
- 清单设计需要领域专业知识
|
||||
- 多标准并存时可能冲突
|
||||
- 动态加载机制增加复杂度
|
||||
|
||||
## 关系
|
||||
|
||||
- 上位概念:[[AgentSkill设计模式]]
|
||||
- 可组合:[[Pipeline]](Pipeline末尾加Reviewer double-check)
|
||||
- 审查清单类型:[[代码审查]]、[[安全审计]]
|
||||
|
||||
## 相关实体
|
||||
|
||||
- [[Anthropic]]:Reviewer模式被用于Claude Code代码审查Skill
|
||||
47
wiki/concepts/ToolWrapper.md
Normal file
47
wiki/concepts/ToolWrapper.md
Normal file
@@ -0,0 +1,47 @@
|
||||
---
|
||||
id: tool-wrapper
|
||||
title: "ToolWrapper"
|
||||
type: concept
|
||||
tags: [Agent, Skill, 设计模式]
|
||||
sources: []
|
||||
last_updated: 2026-03-19
|
||||
---
|
||||
|
||||
# ToolWrapper
|
||||
|
||||
将某个库或框架的规范文档打包成skill的包装模式。Agent只有在真正用到该技术时才会动态加载相关文档(references/目录),而非将所有规则塞入system prompt。
|
||||
|
||||
## 定义
|
||||
|
||||
ToolWrapper是一种Skill设计模式,核心机制是**按需加载**——将领域知识、编码规范、最佳实践封装为可触发的文档模块,仅在Agent检测到相关关键词时激活对应知识。
|
||||
|
||||
## 机制
|
||||
|
||||
- references/目录存放具体技术文档(如conventions.md)
|
||||
- SKILL.md监听特定关键词或事件
|
||||
- 当用户开始使用某技术时,动态加载对应规范
|
||||
- 规范被Agent当作"绝对真理"执行
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 团队内部编码规范分发
|
||||
- 特定框架最佳实践封装
|
||||
- 减少system prompt信息过载
|
||||
- 需要精确控制规范版本和加载时机
|
||||
|
||||
## 优点
|
||||
|
||||
- 按需加载,不浪费上下文token
|
||||
- 规范独立,便于单独更新维护
|
||||
- Agent只在需要时才加载,避免干扰
|
||||
|
||||
## 缺点
|
||||
|
||||
- 需要预先识别和封装所有相关知识
|
||||
- 关键词触发机制可能遗漏边界情况
|
||||
- 多skill并发时可能有加载冲突
|
||||
|
||||
## 关系
|
||||
|
||||
- 上位概念:[[AgentSkill设计模式]]
|
||||
- 并列模式:[[Generator]]、[[Reviewer]]、[[Inversion]]、[[Pipeline]]
|
||||
Reference in New Issue
Block a user