182 lines
6.3 KiB
Markdown
Executable File
182 lines
6.3 KiB
Markdown
Executable File
---
|
||
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技术图生成工具]]
|
||
|