diff --git a/实践积累/智能体软件工程知识图谱.md b/实践积累/智能体软件工程知识图谱.md new file mode 100755 index 0000000..7ccf395 --- /dev/null +++ b/实践积累/智能体软件工程知识图谱.md @@ -0,0 +1,181 @@ +--- +title: 智能体软件工程知识图谱 +tags: + - AI-Agent + - Agentic-SE + - Harness-Engineering + - Superpowers + - 软件工程 + - 知识图谱 +created: 2026-04-21 +sources: + - AgenticSE_Book_CN(艾哈迈德·E·哈桑,2026) + - Harness-Engineering知识体系(11篇原始资料整理,2026-04-20) + - Superpowers技能框架(obra,161.7k stars,2026-04-21) +--- + +# 智能体软件工程知识图谱 + +> 串联三大框架:**Agentic SE** + **Harness Engineering** + **Superpowers** +> +> 核心公式:**AI Agent = Model + Harness** + +--- + +## 一、核心共识 + +三大框架都认同: + +1. **AI Agent = Model + Harness** — 模型提供智能,Harness 让智能可用 +2. **AI 是队友,不是工具** — 能力强大但会犯错,可靠性必须靠工程系统保障 +3. **强制合规 > 依赖理解** — 不指望 AI 自发遵守规范,要构建无法跳过的系统 +4. **验证即完成** — 以可运行的证据(测试通过)代替主观断言 + +--- + +## 二、框架定位对照 + +| 维度 | Agentic SE | Harness Engineering | Superpowers | +|------|------------|-------------------|-------------| +| **定位** | 学科级方法论 | 概念框架 | 具体技能实现 | +| **层级** | 理论与哲学 | 设计原则 | 工程实践 | +| **关注点** | 人+AI团队协作 | 除模型以外的一切 | 编码智能体工作流 | +| **起源** | 学术(哈桑教授) | 多机构综合(LangChain/Anthropic/Thoughtworks等) | 工程实践(Jesse Vincent) | + +--- + +## 三、核心概念映射 + +### 1. Agent = Model + Harness + +| 组件 | Agentic SE 说法 | Harness Engineering 说法 | Superpowers 说法 | +|------|----------------|------------------------|-----------------| +| **Model** | AI队友 | 模型( intelligence) | 底层编码智能体 | +| **Harness** | 工程系统保障可靠性 | 工具/指令/状态管理/验证/运行时基础设施 | 技能系统(Skills) | + +### 2. 五大子系统(对应关系) + +| # | Harness Engineering | Superpowers | Agentic SE | +|---|---------------------|--------------|------------| +| 1 | Instructions | brainstorming / writing-plans | 需求规范 + 设计文档 | +| 2 | State | 设计文档 + plan文件 + git log | 持久化状态管理 | +| 3 | Verification | test-driven-development / verification-before-completion | 验证与测试 | +| 4 | Scope | one feature at a time | 任务边界控制 | +| 5 | Session Lifecycle | init.sh / finishing-a-development-branch | 会话交接与收尾 | + +### 3. 控制类型对照 + +| 类型 | Harness Engineering | Superpowers | +|------|---------------------|--------------| +| **计算型控制** | 测试/linter/类型检查 | test-driven-development | +| **推理型控制** | LLM as Judge / AI代码审查 | requesting-code-review | +| **前馈导引** | AGENTS.md / 技能文件 / 引导脚本 | brainstorming(苏格拉底式提问) | +| **反馈传感** | 静态分析 / 日志 / 测试 | 两阶段审查(规格合规 + 代码质量) | + +### 4. 质量保障维度 + +| 维度 | Harness Engineering | Superpowers | +|------|---------------------|--------------| +| **可维护性** | 重复代码/圈复杂度/测试覆盖率 | test-driven-development | +| **架构适应性** | 性能/可观测性/依赖规则 | writing-plans(详细任务拆解) | +| **行为正确性** | 规格说明/测试套件/e2e验证 | RED-GREEN-REFACTOR + verification-before-completion | + +--- + +## 四、CAR 框架(Control-Agency-Runtime) + +来自学术界(Harness Engineering 引用),与各框架的对应: + +| 维度 | 定义 | 在Superpowers中的体现 | +|------|------|---------------------| +| **Control** | 哪些指令保持权威 | 技能触发在工作前,任何响应前检查 | +| **Agency** | 哪些行动可用 | subagent-driven-development(子智能体执行) | +| **Runtime** | 状态如何延续、故障如何处理 | Session Lifecycle / finishing-a-development-branch | + +--- + +## 五、心理说服原则 + +Superpowers 独家引入(基于沃顿商学院论文《Call Me a Jerk》),可补充到 Harness Engineering: + +| 原则 | 在Superpowers中的应用 | +|------|----------------------| +| **权威(Authority)** | 技能定义为强制工作流,而非建议 | +| **承诺(Commitment)** | 使用技能前要求智能体公开声明 | +| **社会认同(Social Proof)** | 营造"不怕调用错技能"的文化 | + +--- + +## 六、实测效果 + +Anthropic 对比实验(同一模型 + 同一提示词): + +| | 有Harness | 无Harness | +|--|-----------|-----------| +| 成本 | $9 | 更高 | +| 时间 | 20分钟 | 更长 | +| 结果 | 可运行 | 无法运行 | + +**结论**:Harness 改进带来的性能提升,可能比模型本身更显著。 + +--- + +## 七、知识体系演进路径 + +``` +学术界(CAR框架) + ↓ +Harness Engineering(概念框架,11家机构综合) + ↓ +┌─────────────────┴─────────────────┐ +↓ ↓ +Agentic SE(理论专著) Superpowers(工程实践) +(哈桑教授,2026) (Jesse Vincent,161.7k stars) +关注:人+AI协作 关注:编码智能体工作流 +└─────────────────┬─────────────────┘ + ↓ + OpenClaw/Harness实践 +``` + +--- + +## 八、对OpenClaw的指导意义 + +OpenClaw 本身就是一个 Harness 实现: + +| OpenClaw组件 | 对应Harness子系统 | +|-------------|-----------------| +| AGENTS.md / SOUL.md / USER.md | Instructions | +| MEMORY.md / memory/ | State | +| HEARTBEAT.md | Verification + Session Lifecycle | +| Skills系统 | 工具扩展(Tool Harness) | + +**优化方向**: +1. 引入 Superpowers 的"技能触发在工作前"机制 +2. 强化 verification-before-completion(当前HEARTBEAT偏简单检查) +3. 补充前馈导引:每次会话开始时主动说明上下文 +4. 引入 TDD 思维:先定义验证方式,再执行任务 + +--- + +## 九、推荐阅读路径 + +``` +入门 → 《Agentic SE》第四部分(行动指南) + ↓ +进阶 → Harness-Engineering知识体系 + ↓ +实践 → Superpowers技能框架 + ↓ +落地 → OpenClaw优化方向 +``` + +--- + +## 关联文档 + +- [[Harness-Engineering知识体系]] +- [[Superpowers技能框架]] +- [[code-reviewer技能]] +- [[fireworks-tech-graph技术图生成工具]] +