name: system-overview
description: 向用户展示Continuous Claude如何工作 - 带有钩子、内存和协调的固执己见设置
系统概述
向用户展示Continuous Claude如何工作 - 带有钩子、内存和协调的固执己见设置。
何时使用
- 用户问“这如何工作？”
- 用户问“你能记住什么？”
- 用户问“这个设置有什么不同？”
- 用户运行
/system_overview
响应
CONTINUOUS CLAUDE 系统概述
=================================
内存层 (PostgreSQL + pgvector)
------------------------------------
- 78,000+ 个来自过去会话的时态事实
- 会话结束时自动提取学习内容
- 使用嵌入进行语义搜索
召回：uv run python opc/scripts/recall_temporal_facts.py --query "你的主题"
钩子 (9种事件类型已注册)
--------------------------------
SessionStart → 加载连续性账本，重建符号索引
UserPromptSubmit → 技能激活检查，上下文注入
PreToolUse → 智能搜索路由（Grep → TLDR 用于代码）
PostToolUse → 文件声明，编译器反馈
PreCompact → 在上下文压缩前保存状态
Stop → 提取学习内容，创建交接
SubagentStart → 注册生成的代理
SubagentStop → 协调，创建交接
SessionEnd → 清理
连续性系统
-----------------
账本： thoughts/ledgers/CONTINUITY_CLAUDE-{session}.md
交接： thoughts/shared/handoffs/{session}/*.yaml
命令：
/resume_handoff <路径> - 从交接继续
/create_handoff - 创建传输快照
TLDR 代码智能
----------------------
5层分析：AST → 调用图 → CFG → DFG → PDG
与读取原始文件相比节省95%的令牌
自动拦截 .py/.ts/.go/.rs 文件的 Grep
预构建索引：/tmp/claude-symbol-index/symbols.json
设置
-----
运行：uv run python opc/scripts/setup/wizard.py
选项：
[1] 仅SQLite（简单，离线）
[2] PostgreSQL + pgvector（语义搜索）
关键文件
| 组件 |
位置 |
| 钩子注册 |
.claude/settings.json |
| 钩子实现 |
.claude/hooks/src/*.ts |
| 规则（自动注入） |
.claude/rules/*.md |
| 技能 |
.claude/skills/*/SKILL.md |
| 设置向导 |
opc/scripts/setup/wizard.py |
| 召回脚本 |
opc/scripts/recall_temporal_facts.py |
| 存储学习 |
opc/scripts/core/store_learning.py |
| 符号索引构建器 |
opc/scripts/build_symbol_index.py |
环境变量
| 变量 |
目的 |
CONTINUOUS_CLAUDE_DB_URL |
PostgreSQL 连接 |
VOYAGE_API_KEY |
嵌入（可选） |
BRAINTRUST_API_KEY |
追踪（可选） |
CLAUDE_PROJECT_DIR |
由Claude Code自动设置 |