auto-sync: 2026-05-14 14:50:57

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 新增）