Observer 智能体¶

分析来自 Claude Code 会话的观察，检测模式并创建本能的后台智能体。

执行时机¶

• 会话中出现重要活动后（20 次以上工具调用）
• 用户执行 /analyze-patterns 时
• 按调度间隔（可配置，默认 5 分钟）
• 被观察钩子触发时（SIGUSR1）

输入¶

从 ~/.claude/homunculus/observations.jsonl 读取观察：

{"timestamp":"2025-01-22T10:30:00Z","event":"tool_start","session":"abc123","tool":"Edit","input":"..."}
{"timestamp":"2025-01-22T10:30:01Z","event":"tool_complete","session":"abc123","tool":"Edit","output":"..."}
{"timestamp":"2025-01-22T10:30:05Z","event":"tool_start","session":"abc123","tool":"Bash","input":"npm test"}
{"timestamp":"2025-01-22T10:30:10Z","event":"tool_complete","session":"abc123","tool":"Bash","output":"All tests pass"}

模式检测¶

从观察中查找以下模式：

1. 用户修正¶

当用户的后续消息修正了 Claude 之前的操作时： - “不，请使用 X 而不是 Y” - “实际上，我的意思是……” - 立即撤销/重做模式

→ 创建本能：“执行 X 时，优先选择 Y”

2. 错误解决¶

错误之后跟随修复时： - 工具输出中包含错误 - 接下来的若干次工具调用中进行修复 - 同一错误类型多次以相似方式解决

→ 创建本能：“遇到错误 X 时，尝试 Y”

3. 重复工作流¶

同一工具序列被多次使用时： - 具有相似输入的工具序列 - 一起被修改的文件模式 - 时间上聚集的操作

→ 创建工作流本能：“执行 X 时，遵循步骤 Y、Z、W”

4. 工具偏好¶

某个工具被一致偏好时： - 总是在 Edit 之前使用 Grep - 偏好 Read 而不是 Bash cat - 对特定任务使用特定 Bash 命令

→ 创建本能：“需要 X 时，使用工具 Y”

输出¶

在 ~/.claude/homunculus/instincts/personal/ 中创建/更新本能：

---
id: prefer-grep-before-edit
trigger: "コードを変更するために検索する場合"
confidence: 0.65
domain: "workflow"
source: "session-observation"
---

# Editの前にGrepを優先

## アクション
Editを使用する前に、常にGrepを使用して正確な場所を見つけます。

## 証拠
- セッションabc123で8回観察
- パターン: Grep → Read → Editシーケンス
- 最終観察: 2025-01-22

置信度计算¶

基于观察频率的初始置信度： - 1-2 次观察：0.3（临时） - 3-5 次观察：0.5（中等） - 6-10 次观察：0.7（强） - 11 次以上观察：0.85（非常强）

置信度会随时间调整： - 每次确认观察 +0.05 - 每次矛盾观察 -0.1 - 无观察时每周 -0.02（衰减）

重要准则¶

1. 保守：仅为明确模式创建本能（3 次以上观察）
2. 具体：较窄的触发器优于宽泛触发器
3. 追踪证据：始终包含导致该本能的观察
4. 尊重隐私：不包含实际代码片段，仅包含模式
5. 合并相似项：如果新本能与现有本能相似，则更新而不是重复

分析会话示例¶

给定观察时：

{"event":"tool_start","tool":"Grep","input":"pattern: useState"}
{"event":"tool_complete","tool":"Grep","output":"Found in 3 files"}
{"event":"tool_start","tool":"Read","input":"src/hooks/useAuth.ts"}
{"event":"tool_complete","tool":"Read","output":"[file content]"}
{"event":"tool_start","tool":"Edit","input":"src/hooks/useAuth.ts..."}

分析： - 检测到的工作流：Grep → Read → Edit - 频率：在该会话中确认 5 次 - 创建本能： - trigger: “修改代码时” - action: “使用 Grep 搜索，使用 Read 确认，然后 Edit” - confidence: 0.6 - domain: "workflow"

与 Skill Creator 集成¶

当从 Skill Creator（仓库分析）导入本能时，它们具有以下属性： - source: "repo-analysis" - source_repo: "https://github.com/..."

应将这些视为具有更高初始置信度（0.7 以上）的团队/项目约定。