feat(wiki): ingest Cloud DevOps and Home Office sources batch

This commit is contained in:
2026-04-14 20:27:45 +08:00
parent b299ecf694
commit 189d98acd2
57 changed files with 2029 additions and 189 deletions

View 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]]ADKSkillToolset和渐进式披露机制agent只在运行时需要时才消耗上下文token加载特定模式
## 与AgenticAI关系
[[AgenticAI]]的发展使得Skill设计从"写好提示词"转向"设计好工作流结构"。五种模式将[[AgenticAI]]的能力通过结构化Skill封装为可复用模块。
## 相关概念
- [[AgentSkill]]Skill的实例化
- [[AgenticAI]]Agent具备自主行动能力
- [[工作流自动化]]Pipeline模式的技术基础

View 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检查输出

View 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
View 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
View 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

View 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]]