名称: 上下文管理器 描述: 提供发现、获取、收集、提取、压缩、组织、清理和引导工作流的上下文管理技能，用于项目上下文管理 版本: 1.0.0 作者: opencode 类型: 技能 类别: 开发 标签:
- 上下文
- 管理
- 发现
- 组织
- 外部文档
上下文管理器技能
目的: 全面的上下文管理操作，提供清晰的指导、惰性加载和安全操作，用于发现、组织和维护项目上下文。
我能做什么
我提供8个强大的上下文管理操作：
- 发现 - 按主题或路径查找上下文文件
- 获取 - 从库中获取外部文档
- 收集 - 从摘要文件中提取上下文
- 提取 - 从上下文中提取特定信息
- 压缩 - 减小大文件大小
- 组织 - 按关注点重构上下文
- 清理 - 删除过时或临时文件
- 处理 - 上下文操作的引导工作流
快速开始
1. 发现上下文
bash .opencode/skills/context-manager/router.sh discover authentication
查找与认证模式相关的所有上下文文件。
2. 获取外部文档
bash .opencode/skills/context-manager/router.sh fetch "Drizzle ORM" "modular schemas"
从外部库检索实时文档。
3. 收集上下文
bash .opencode/skills/context-manager/router.sh harvest ANALYSIS.md
从摘要文件中提取关键概念到永久上下文。
4. 提取信息
bash .opencode/skills/context-manager/router.sh extract code-quality.md "naming conventions"
从上下文文件中提取特定信息。
5. 压缩文件
bash .opencode/skills/context-manager/router.sh compress .opencode/context/ 100KB
减小大上下文文件以节省空间。
6. 组织上下文
bash .opencode/skills/context-manager/router.sh organize .opencode/context/
按关注点重构上下文以改善组织。
7. 清理过时文件
bash .opencode/skills/context-manager/router.sh cleanup .tmp/ 7
删除临时或旧文件（超过7天）。
8. 引导工作流
bash .opencode/skills/context-manager/router.sh process "organize authentication context" .opencode/context/
为复杂上下文操作提供逐步指导。
操作参考
操作1: 发现
目的: 使用智能发现或直接搜索查找上下文文件
何时使用:
- 需要查找仓库中的所有上下文文件
- 按主题查找特定上下文
- 映射上下文结构
- 了解现有上下文
语法:
discover [目标]
示例:
# 按主题发现
./router.sh discover "authentication patterns"
# 发现所有上下文
./router.sh discover "all context files"
# 在特定目录发现
./router.sh discover ".opencode/context/core/"
输出:
- 发现的文件列表及路径和大小
- 文件统计（数量、总大小、最后更新）
- 按类型分类
- 下一步建议
操作2: 获取
目的: 使用ExternalScout获取外部文档
何时使用:
- 需要外部库的实时文档
- 设置新的外部库集成
- 需要版本特定文档
- 想为团队缓存外部文档
语法:
fetch [库] [主题]
示例:
# 获取单个库
./router.sh fetch "Drizzle ORM" "modular schemas"
# 获取多个库
./router.sh fetch "Drizzle ORM" "Better Auth" "Next.js" "modular schemas" "integration" "app router"
# 用特定查询获取
./router.sh fetch "Better Auth" "Next.js App Router integration with Drizzle adapter"
输出:
- 获取的文件及路径
- 文件大小和统计
- 来源URL
- 如何在上下文中引用
- 清单更新
操作3: 收集
目的: 从摘要文件中提取上下文并创建永久上下文
何时使用:
- 有应成为上下文的摘要文档
- 需要将临时笔记转换为永久上下文
- 想从较大文档中提取关键概念
- 需要组织分散的信息
语法:
harvest [源文件]
示例:
# 从分析中收集
./router.sh harvest DEVELOPER_PROFILE_ANALYSIS.md
# 从头脑风暴中收集
./router.sh harvest AGENT_NAMING_BRAINSTORM.md
# 从UX分析中收集
./router.sh harvest UX_ANALYSIS_THREE_MAIN_AGENTS.md
输出:
- 创建的上下文文件路径
- 节省的空间（原始 vs. 收集）
- 内容结构
- 更新的导航文件
- 如何使用新上下文
操作4: 提取
目的: 从上下文文件中提取特定信息
何时使用:
- 需要从上下文中提取特定信息
- 创建摘要或报告
- 为子代理构建上下文包
- 验证上下文完整性
语法:
extract [文件] [要提取的内容]
示例:
# 提取命名约定
./router.sh extract code-quality.md "naming conventions"
# 提取测试模式
./router.sh extract test-coverage.md "test patterns"
# 提取所有标准
./router.sh extract ".opencode/context/core/" "all standards"
输出:
- 按主题组织的提取信息
- 源文件引用
- 相关性评分
- 使用建议
- 下一步
操作5: 压缩
目的: 压缩大上下文文件以节省空间
何时使用:
- 上下文文件很大（>100 KB）
- 需要减少磁盘空间使用
- 归档旧上下文
- 准备分发上下文
语法:
compress [目标] [大小阈值]
示例:
# 压缩大文件
./router.sh compress ".opencode/context/" "100 KB"
# 压缩所有上下文
./router.sh compress ".opencode/context/"
# 压缩并归档
./router.sh compress ".opencode/context/development/" "50 KB"
输出:
- 压缩的文件及路径
- 节省的空间（前/后）
- 压缩率
- 解压说明
- 清单更新
操作6: 组织
目的: 按关注点（你在做什么）而非功能重新组织上下文文件
何时使用:
- 上下文分散在多个位置
- 需要按关注点/主题重新组织
- 创建新上下文结构
- 整合相关上下文
语法:
organize [目标]
示例:
# 按关注点组织
./router.sh organize ".opencode/context/"
# 组织特定主题
./router.sh organize ".opencode/context/development/"
输出:
- 当前结构分析
- 提议的新结构
- 移动和重组的文件
- 更新的引用
- 导航更新
- 新结构概述
操作7: 清理
目的: 清理过时、临时或未使用的上下文文件
何时使用:
- 删除临时文件（.tmp/）
- 删除旧外部上下文（>7天）
- 删除重复上下文
- 归档未使用上下文
语法:
cleanup [目标] [超过天数]
示例:
# 清理 .tmp 目录
./router.sh cleanup ".tmp/"
# 清理旧外部上下文
./router.sh cleanup ".tmp/external-context/" "7"
# 清理过时会话
./router.sh cleanup ".tmp/sessions/" "3"
输出:
- 要删除的文件
- 要释放的空间
- 影响分析
- 恢复说明
- 清单更新
操作8: 处理
目的: 为处理上下文提供引导工作流
何时使用:
- 需要上下文操作的逐步指导
- 处理多个上下文文件
- 学习上下文管理工作流
- 自动化上下文处理
语法:
process [目标] [范围]
示例:
# 处理认证上下文
./router.sh process "organize authentication context" ".opencode/context/development/"
# 处理所有开发上下文
./router.sh process "organize all development context" ".opencode/context/development/"
# 处理外部上下文
./router.sh process "fetch, persist, and reference external context" ".tmp/external-context/"
输出:
- 逐步工作流
- 进度指示器
- 发现的上下文
- 处理计划
- 执行结果
- 验证结果
- 摘要和下一步
常见工作流
工作流1: 发现与提取
1. 发现上下文: "authentication"
→ 查找所有认证相关上下文
2. 从: "security-patterns.md" 提取: "auth patterns"
→ 获取特定模式
3. 显示结果
→ 准备在会话中使用
工作流2: 获取与引用
1. 获取外部文档: "Drizzle ORM"
→ 获取实时文档
2. 显示文件路径
→ .tmp/external-context/drizzle-orm/...
3. 在会话上下文中引用
→ 添加到 "## 获取的外部上下文"
4. 传递给子代理
→ 包含在子任务JSON中
工作流3: 收集与组织
1. 收集上下文从: "ANALYSIS.md"
→ 提取关键概念
2. 按: "concern" 组织上下文
→ 为清晰度重构
3. 更新文档
→ 显示新结构
4. 删除原始摘要
→ 清理临时文件
工作流4: 清理与维护
1. 清理 .tmp/ 目录
→ 删除临时文件
2. 清理超过: "7 days" 的外部上下文
→ 删除过时外部文档
3. 显示释放的空间
→ 提供统计
4. 更新清单
→ 保持跟踪准确
关键原则
1. 惰性加载
- 先发现文件（glob, grep）
- 只加载所需内容（读取特定文件）
- 增量处理（不加载整个仓库）
- 引用上下文文件，不重复
2. 清晰指导
- 解释每一步在做什么
- 显示文件路径和大小
- 提供前后指标
- 建议下一步
- 在破坏性操作前请求确认
3. 上下文引用
- 发现时：引用找到的文件
- 处理时：引用应用的标准
- 组织时：显示使用的模式
- 清理时：解释删除的内容
4. 安全操作
- 破坏性操作前请求确认
- 需要时创建备份
- 操作后验证完整性
- 提供恢复说明
文件结构
.opencode/skills/context-manager/
├── SKILL.md # 本文件
├── router.sh # CLI路由器（入口点）
├── CONTEXT_SKILL_QUICK_START.md # 快速开始指南
├── context-manager.md # 详细操作指南
└── navigation.md # 导航索引
集成点
与ContextScout
- ContextScout发现上下文文件
- 本技能帮助组织ContextScout找到的内容
- 可以从ContextScout结果中收集上下文
与ExternalScout
- ExternalScout获取外部文档
- 本技能持久化和组织获取的文档
- 可以在操作中引用外部上下文
与TaskManager
- TaskManager在任务定义中引用上下文
- 本技能确保上下文文件存在且有效
- 可以分类哪些任务使用哪些上下文
与其他子代理
- 所有子代理依赖上下文结构
- 本技能维护和验证上下文
- 可以识别子代理需要的上下文缺口
成功标准
你成功当： ✅ 上下文文件被高效发现 ✅ 外部文档被获取并持久化 ✅ 上下文从摘要中被收集 ✅ 关键信息被清晰提取 ✅ 大文件被安全压缩 ✅ 上下文按关注点组织 ✅ 过时文件被安全清理 ✅ 用户在每一步都有清晰指导 ✅ 所有操作可逆 ✅ 文档已更新
提示与最佳实践
1. 定期发现
定期运行发现操作以理解上下文结构并识别缺口。
2. 按关注点组织
按你在做什么（认证、测试等）而非功能（标准、指南）组织上下文。
3. 惰性加载外部文档
仅在需要时获取外部文档，而非预先。
4. 收集摘要
使用收集将临时分析文档转换为永久上下文。
5. 定期清理
安排定期清理操作以删除过时临时文件。
6. 更改后验证
更改后始终验证上下文完整性。
7. 文档组织
组织上下文时保持navigation.md文件最新。
8. 引用标准
提取上下文时，始终引用源文件。
故障排除
“上下文文件未找到”
运行 discover all context files 查看存在什么和在哪里。
“外部文档获取失败”
检查库名是否正确且ExternalScout可用。
“收集创建了空文件”
源文件可能没有足够高信号内容。手动审查并添加。
“组织失败”
检查所有引用文件是否存在且navigation.md有效。
“清理删除了太多”
检查备份 .backup/cleanup-{date}.tar.gz 以恢复。
上下文管理器技能 - 发现、组织并维护你的项目上下文！