sanguo_llmwiki/skills/wiki-agent/SKILL.md

name, description, trigger

name	description	trigger
wiki-agent	从特定 AI agent 的历史记录中定向录入知识到 wiki	当用户需要从 agent 历史记录中提取有价值信息时

Wiki Agent

使用场景

• 从 Claude Code 对话历史提取知识
• 录入特定 agent 的工作记录
• 整理项目开发过程
• 归档问题解决经验

操作步骤

1. 指定 Agent 来源

   • 确定项目路径
   • 定位 agent 历史文件
   • 选择时间范围

2. 解析历史记录

   • 读取对话 JSONL 文件
   • 提取用户和 AI 消息
   • 识别代码变更

3. 智能过滤

   • 移除重复内容
   • 过滤元指令
   • 提取关键见解

4. 结构化处理

   • 按主题分组
   • 生成页面结构
   • 创建相关链接

5. 写入 wiki

   • 保存到 projects/ 或 journal/
   • 更新项目索引

支持的 Agent 类型

Agent	来源路径	说明
Claude Code	.claude/projects/*/.../*.jsonl	Claude Code 对话历史
Generic	自定义路径	通用 JSONL 格式

JSONL 格式

{"role": "user", "content": "问题", "timestamp": "2024-01-15T10:00:00Z"}
{"role": "assistant", "content": "回答", "timestamp": "2024-01-15T10:00:01Z"}
{"type": "tool_use", "tool": "function", "input": {...}}
{"type": "tool_result", "output": "..."}

页面模板

---
name: agent-history-YYYY-MM-DD
description: Agent 工作记录摘要
metadata:
  type: journal | project
  agent: claude-code
  project: project-name
  date_range: YYYY-MM-DD to YYYY-MM-DD
  tags: [agent, history]
---

# Agent 工作记录：<项目名称>

**日期**: YYYY-MM-DD
**Agent**: Claude Code
**消息数**: 42

## 工作摘要
<对话主题摘要>

## 关键决策

### 决策 1
**上下文**: ...
**决定**: ...
**原因**: ...

## 实施记录

### 任务 1
**问题**: ...
**解决方案**: ...
**代码变更**: file.js:100

### 任务 2
**问题**: ...
**解决方案**: ...

## 遇到的问题

### 问题 1
**描述**: ...
**解决过程**: ...
**最终方案**: ...

## 获得的见解

- 见解 1
- 见解 2

## 使用的工具
- tool1 (用途)
- tool2 (用途)

## 相关链接
- [[related-project]]
- [[related-practice]]

输出格式

{
  "success": true,
  "agent": "claude-code",
  "project": "project-name",
  "saved_to": "projects/project-history-2024-01-15.md",
  "summary": {
    "messages_processed": 120,
    "decisions_extracted": 3,
    "problems_solved": 2,
    "insights_captured": 5,
    "tools_used": ["tool1", "tool2"]
  },
  "pages_created": 2
}

智能提取

1. 决策识别

   • 查找 "决定"、"选择" 等关键词
   • 提取决策背景和原因
   • 记录决策结果

2. 问题解决

   • 识别错误和异常
   • 提取排查过程
   • 记录最终方案

3. 代码变更

   • 提取文件编辑记录
   • 记录变更原因
   • 保存关键代码片段

4. 见解提取

   • 识别学习点
   • 提取最佳实践
   • 记录经验教训

MCP 集成

调用 MCP Server 工具：

• wiki_query - 查找相关项目知识
• wiki_ingest - 蒸馏为 wiki 格式
• cross_linker - 创建相关链接

配置选项

~/.sanguo-llmwiki/config.yaml：

agent:
  default_agent: "claude-code"
  history_path: ".claude/projects"
  max_messages: 500        # 最大处理消息数
  include_code: true       # 是否包含代码变更
  group_by_topic: true     # 按主题分组

使用示例

录入最近的 agent 历史：

wiki-agent --project my-project --days 7

指定时间范围：

wiki-agent --project my-project --from 2024-01-01 --to 2024-01-15

注意事项

1. 注意敏感信息过滤
2. 尊重数据隐私
3. 验证 JSONL 格式正确
4. 避免重复录入相同内容