diff --git a/docs/design/architecture-v2.md b/docs/design/architecture-v2.md index 1e4240a..f60cb71 100644 --- a/docs/design/architecture-v2.md +++ b/docs/design/architecture-v2.md @@ -2112,35 +2112,73 @@ observation 写入条件(必须满足至少一条): 这是 PRD B1(AI 帮用户想清楚要什么)的全程贯穿,不限于 Phase 1。 在庞统的 prompt 中加入"用户意图一致性检查"规则。 -#### 3.12.8 AI native Skill 体系(v2.5 新增) +#### 3.12.8 AI native Skill 体系(v2.6 修订) -> **核心理念**:v1.0 的 Skill 是操作手册(告诉 AI 怎么做),v2.0 的 Skill 是行为准则(告诉 AI 做什么是对的)。 -> AI 自己决定具体怎么做,Skill 只设定边界。 +> **v1.0 的 Skill 问题**:把命令操作手册写到 Skill 里——"数据获取步骤:1. 连接数据库 2. 执行 SQL 3. 保存 CSV"。 +> 这不是 AI native,这是给 AI 写操作流程。AI 自己会决定怎么操作。 +> +> **v2.0 AI native Skill**:不是告诉 AI 怎么做,而是设定边界——做什么是好的、做什么是错的、遇到什么情况该怎么想。 +> AI 自己决定具体步骤。 -**三层 Skill 模型**(综合 oh-my-claudecode、Hermes、Nuwa、Agent Skills 生命周期): +**三层 Skill 模型**: -| 层级 | 名称 | 内容 | 示例 | +| 层级 | 名称 | 内容 | 类比 | |------|------|------|------| -| L1 | Principles(原则) | 做事的底线和方向 | "数据获取后必须先检查质量再回报" | -| L2 | Patterns(模式) | 遇到什么情况应该怎么做 | "如果发现缺失值 > 5%,标记异常区间" | -| L3 | Anti-patterns(反模式) | 绝对不能做的事 | "绝不能假设数据是干净的" | +| L1 | **Principles**(原则) | 做事的底线和方向 | 宪法 | +| L2 | **Patterns**(模式) | 遇到什么情况应该怎么想 | 判例法 | +| L3 | **Anti-patterns**(反模式) | 绝对不能做的事 | 刑法 | + +**具体 Skill 内容示例**(`data-acquisition/SKILL.md`): + +```markdown +# 数据获取 Skill(赵云) + +## L1 原则 +- 数据获取后必须先检查质量再回报 +- 任何数据源声称已清洗都不能信任 +- 产出物必须包含数据质量报告 + +## L2 模式 +- 如果发现缺失值 < 5%:前值填充,记录在 observation +- 如果发现缺失值 > 5%:标记异常区间,在 observation 中建议后续步骤如何处理 +- 如果发现数据时间范围与任务要求不符:立即回报,不自行裁剪 +- 如果数据源有多个版本:选择最完整的,在 observation 中说明选择理由 + +## L3 反模式 +- 绝不能假设数据是干净的 +- 绝不能默默修复数据问题而不在 observation 中记录 +- 绝不能返回未经检查的数据 +- 绝不能跳过数据质量报告直接标记步骤完成 +``` + +**与 v1.0 的核心区别**: +- v1.0:"连接 jqdatasdk,执行 get_price(),保存到 CSV"(操作手册) +- v2.0:"获取后必须检查质量,缺失值要记录"(行为准则) +- AI 自己决定用什么工具、什么 API、什么格式 **v2.0 预设 Skill 目录**: ``` skills/ -├── task-bootstrap/SKILL.md # Agent 启动协议(感知→执行→观察) -├── task-report/SKILL.md # Agent 完成报告协议 -├── quality-gate/SKILL.md # 产出物自检协议 -├── orchestration-strategy/SKILL.md # 庞统调度策略(五原则) -├── data-acquisition/SKILL.md # 数据获取最佳实践(赵云) -├── strategy-coding/SKILL.md # 策略编码最佳实践(张飞) -├── risk-review/SKILL.md # 风控审核最佳实践(关羽) -└── experience-distill/SKILL.md # 经验蒸馏最佳实践 +├── task-bootstrap/SKILL.md # Agent 启动协议(感知→执行→观察) +├── task-report/SKILL.md # Agent 完成报告协议 +├── quality-gate/SKILL.md # 产出物自检协议 +├── orchestration-strategy/SKILL.md # 庞统调度策略(五原则 + 防降级) +├── data-acquisition/SKILL.md # 数据获取行为准则(赵云) +├── strategy-coding/SKILL.md # 策略编码行为准则(张飞) +├── risk-review/SKILL.md # 风控审核行为准则(关羽) +├── infra-management/SKILL.md # 基础设施管理行为准则(姜维) +└── experience-distill/SKILL.md # 经验蒸馏行为准则 ``` -每个 Skill 包含 L1(原则)+ L2(模式)+ L3(反模式)三层。 -Skill 内容用 Markdown 格式(LLM 理解最好、token 最省),不用 JSON。 +**Skill 格式**:Markdown(LLM 理解最好、token 最省、自由度最高)。 +每个 Skill 包含完整的 L1 + L2 + L3 三层。 + +**Skill 加载方式**: +- 每个 Agent 的 SOUL.md 中引用自己的专属 Skill +- task-bootstrap 和 quality-gate 通过任务消息模板注入(所有 Agent 通用) +- orchestration-strategy 通过庞统的 SOUL.md 注入 +- 经验蒸馏完成后,相关经验自动注入到后续任务的上下文中(半自动 Skill 更新) #### 3.12.9 庞统调度策略 Skill(v2.5 新增)