auto-sync: 2026-05-27 08:56:03
This commit is contained in:
cfdaily
@@ -345,9 +345,125 @@ input → [Stage1] → [Stage2] → [Stage3] → output
|
||||
|
||||
---
|
||||
|
||||
## 7. 下一步
|
||||
## 7. 调研结论与方向决策（2026-05-27 第二轮）
|
||||
|
||||
基于以上调研：
|
||||
1. 从 28 个场景中筛选近期/远期
|
||||
2. 选择组合设计模式
|
||||
3. 输出 v2.7.2/v2.8 Pipeline 架构设计方案
|
||||
### 7.1 核心结论：不做 Pipeline 框架
|
||||
|
||||
经过第 1~6 节的调研和讨论，得出关键结论：
|
||||
|
||||
**不需要代码层面的 Pipeline 框架。** 各种执行模式（parallel/loop/saga/interactive）是执行路径的选择，不是代码层面的 Pipeline 类。Agent 自己根据黑板信息决定执行策略。
|
||||
|
||||
**理由**：
|
||||
- 28 个场景的业务类型无限扩展，但执行模式不需要预定义
|
||||
- 两层抽象：业务类型（task_type，无限）+ 执行模式（Agent 自己选，不需要预定义）
|
||||
- 代码层硬编码执行模式 = 传统做法，不是 AI native
|
||||
|
||||
### 7.2 新方向：Daemon 退化 + Agent 进化
|
||||
|
||||
| 维度 | 当前（v2.7） | 未来（AI Native） |
|
||||
|------|-------------|-------------------|
|
||||
| Daemon 角色 | 调度器 + 路由器 + 决策者 | 投递员 + 看护人 |
|
||||
| Agent 角色 | 被动执行者（固定步骤 prompt） | 自主决策者（读黑板→想→干→写回） |
|
||||
| 谁决定执行路径 | Daemon（if/else + YAML） | Agent（根据黑板信息自主判断） |
|
||||
| Agent 间通信 | 无（Daemon 中央调度） | 黑板 handoff comment + observation |
|
||||
|
||||
**业界印证**：
|
||||
- Claude Code Agent Teams：Agent 自己 flock() claim 任务
|
||||
- Hermes Kanban：Agent 有 kanban_* 工具直接操作黑板
|
||||
- PRD v3.0 B3：“黑板是唯一真相源，所有 Agent 读它、想、行动、写回结果”
|
||||
|
||||
### 7.3 Agent Prompt 结构对比调研
|
||||
|
||||
| 系统 | “能做什么”怎么表达 | “全局视角”怎么给 | 自主程度 |
|
||||
|------|------------------|-----------------|----------|
|
||||
| **Claude Code** | 工具列表（自动可用） | 文件系统自己读 | 高 |
|
||||
| **Hermes Kanban** | kanban_* 工具集（环境变量激活） | kanban_show() 自己读 | 中 |
|
||||
| **我们当前** | prompt 里写 curl 命令模板 | 不给全局 | 低 |
|
||||
| **v2.9 目标** | API 列表 + 约束 | 黑板 API 自己读 | 高 |
|
||||
|
||||
### 7.4 工具评估
|
||||
|
||||
在第二轮讨论中评估了以下工具：
|
||||
|
||||
#### CodeGraph
|
||||
- **来源**: `knowledge_base/codegraph/`
|
||||
- **功能**: MCP 服务器，索引代码 AST（符号关系、调用图、影响分析）
|
||||
- **评估结论**: ❌ 对 L3 知识注入无用
|
||||
- **理由**: 索引的是代码文件的结构（函数/类/调用链），而 L3 知识注入检索的是 Markdown 蒸馏知识文档（practices/concepts/skills）。两个完全不同的数据类型和查询需求。
|
||||
- **潜在用途**: 将来对编码 Agent 的工具增强（让张飞快速定位代码）有用，但不是知识注入。
|
||||
|
||||
#### Understand Anything
|
||||
- **来源**: `knowledge_base/understand-anything/`
|
||||
- **功能**: Claude Code 插件，支持 `/understand-knowledge` 命令解析 LLM Wiki 的 index.md + wikilinks，构建知识图谱可视化
|
||||
- **评估结论**: ⚠️ 间接有用
|
||||
- **理由**: `/understand-knowledge` 可以可视化 LLM Wiki 知识图谱（社区聚类 + 隐含关系发现），适合人工维护 wiki 时探索。但它是 Claude Code 插件，产出是 Dashboard 不是 API，不适合运行时 Daemon 调用。
|
||||
- **适合场景**: 知识库页面 > 500 页时人工探索用，不是运行时组件。
|
||||
|
||||
#### MattPocock Handoff Skill
|
||||
- **来源**: `knowledge_base/mattpocock-skills/skills/in-progress/handoff/`
|
||||
- **功能**: 把当前对话压缩成一份交接文档（handoff document），让下一个 fresh agent 能接手
|
||||
- **评估结论**: ✅ 直接有用，已采纳
|
||||
- **理由**: 解决的是 Agent 间上下文传递的核心问题。当前 Daemon 中央摘要式传话信息逐层丢失（思考过程→设计权衡→遇到的问题）。Handoff 思路是让产出 Agent 主动写交接文档到黑板，下一个 Agent 自主读取。
|
||||
- **采纳方式**: 不是装这个 skill（那是 Claude Code 用的），而是借鉴其设计理念改造 prompt。
|
||||
|
||||
### 7.5 知识注入调研：LLM Wiki 复用
|
||||
|
||||
**LLM Wiki 已有完整基础设施，不需要另建 L3 知识层：**
|
||||
|
||||
| 内容 | 数量 |
|
||||
|------|------|
|
||||
| wiki-vault 总页面 | ~273 个 md 文件 |
|
||||
| practices（蒸馏实践） | 118 个 |
|
||||
| concepts | 8 个 |
|
||||
| skills | 5 个 |
|
||||
| projects | 40+ 个 |
|
||||
|
||||
LLM Wiki 的检索分级原语直接复用为知识注入方案：
|
||||
|
||||
| 检索级别 | 原语 | 成本 |
|
||||
|---------|------|------|
|
||||
| 第 1 级 | grep `index.md` 的 summary 行 | ~50 token/关键词 |
|
||||
| 第 2 级 | 读页面 `summary` frontmatter 字段 | ~100 token/页面 |
|
||||
| 第 3 级 | grep 页面内特定段落 | ~200 token/段 |
|
||||
| 第 4 级 | 读整个页面 | ~500+ token/页 |
|
||||
|
||||
**spawn 时用第 1 级即可**：3 个关键词 × 2 条匹配 = 6 条 summary，~300 token。便宜到可以每次都跑。
|
||||
|
||||
### 7.6 知识管理体系与本次设计的关系
|
||||
|
||||
| 知识管理体系 | 和 v2.8 设计关系 | 说明 |
|
||||
|------------|-----------------|------|
|
||||
| LLM Wiki 三层架构 | ✅ 直接用 | 就是 L3 知识层 |
|
||||
| wiki-query skill | ✅ 直接用 | 检索分级原语复用 |
|
||||
| wiki-ingest skill | ✅ 后续用 | 新调研结果可 ingest 进 wiki |
|
||||
| 记忆分区（memory/ 四区） | ⚠️ 正交 | Agent 自身记忆管理，和 prompt 进化独立 |
|
||||
| Skill 三级约束 | ⚠️ 正交 | 产出格式约束，和执行自主度独立 |
|
||||
| Skill 集群模板 | ❌ 不做 | 和 Agent 自主决策方向矛盾 |
|
||||
| 四层加载机制 | ✅ 对齐 | ①固化=SOUL.md ②注册=SKILL.md ③注入=BootstrapBuilder ④检索=wiki-query |
|
||||
|
||||
### 7.7 最终决策
|
||||
|
||||
| 决策项 | 结论 |
|
||||
|--------|------|
|
||||
| 是否新建 Pipeline 框架 | ❌ 不做。Agent 自主决定执行路径 |
|
||||
| 是否新建 L3 知识库 | ❌ 不做。复用 LLM Wiki（273 页） |
|
||||
| 是否新建黑板摘要注入 | ❌ 不做。Agent 自己读黑板 |
|
||||
| 是否新建 blackboard_* 工具 | ❌ 优先级低。curl 够用 |
|
||||
| 是否采纳 Handoff 理念 | ✅ 是。Agent 主动写交接文档到黑板 |
|
||||
| 是否采纳 LLM Wiki 检索原语 | ✅ 是。spawn 前 grep index.md 注入 summary |
|
||||
|
||||
---
|
||||
|
||||
## 8. 调研产出
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `docs/research/pipeline-architecture-research.md` | 本文档：28场景+8实践+6模式+方向决策 |
|
||||
| `docs/design/v2.8-direction-notes.md` | 设计方向备忘：核心结论+改动清单+工具评估 |
|
||||
| `docs/design/v2.8-pipeline-architecture.md` | Pipeline 架构设计 v1.0~v2.0（**已废弃**） |
|
||||
| `docs/design/v2.8-task-type-pipeline.md` | Task Type Pipeline 设计（**已废弃**） |
|
||||
| `docs/design/v2.7.2-pipeline-refactor.md` | v2.7.2 Pipeline 分离设计（部分已完成） |
|
||||
|
||||
## 9. 下一步
|
||||
|
||||
基于调研结论，具体实现计划见 `docs/design/v2.8-direction-notes.md` 第五节。
|
||||
|
||||
Reference in New Issue
Block a user