context-manager

Context Manager Skill

用途：提供全面的上下文管理操作，包含清晰的指导、按需加载和安全操作，用于发现、整理和维护项目上下文。

---

我能做什么

我提供 8 种强大的上下文管理操作：

1. DISCOVER - 按主题或路径查找上下文文件
2. FETCH - 获取外部库的文档
3. HARVEST - 从摘要文件中提取上下文
4. EXTRACT - 从上下文中提取特定信息
5. COMPRESS - 减小大型文件的大小
6. ORGANIZE - 按关注点重组上下文
7. CLEANUP - 删除过时或临时文件
8. PROCESS - 上下文操作的引导式工作流

---

快速入门

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

用途：通过智能发现或直接搜索查找上下文文件

适用场景：

• 需要查找存储库中的所有上下文文件
• 按主题查找特定上下文
• 映射上下文结构
• 了解现有上下文

语法：

discover [target]

示例：

# Discover by topic
./router.sh discover "authentication patterns"

# Discover all context
./router.sh discover "all context files"

# Discover in specific directory
./router.sh discover ".opencode/context/core/"

输出：

• 已发现文件的列表，包含路径和大小
• 文件统计信息（数量、总大小、上次更新时间）
• 按类型分类
• 后续步骤建议

---

操作 2：FETCH

用途：使用 ExternalScout 获取外部文档

适用场景：

• 需要外部库的最新文档
• 设置新的外部库集成
• 需要特定版本的文档
• 希望为团队缓存外部文档

语法：

fetch [libraries] [topics]

示例：

# Fetch single library
./router.sh fetch "Drizzle ORM" "modular schemas"

# Fetch multiple libraries
./router.sh fetch "Drizzle ORM" "Better Auth" "Next.js" "modular schemas" "integration" "app router"

# Fetch with specific query
./router.sh fetch "Better Auth" "Next.js App Router integration with Drizzle adapter"

输出：

• 已获取文件的路径
• 文件大小和统计信息
• 来源 URL
• 如何在上下文中引用
• 清单更新

---

操作 3：HARVEST

用途：从摘要文件中提取上下文并创建永久上下文

适用场景：

• 有应转为上下文的摘要文档
• 需要将临时笔记转换为永久上下文
• 希望从较大的文档中提取关键概念
• 需要整理分散的信息

语法：

harvest [source-file]

示例：

# Harvest from analysis
./router.sh harvest DEVELOPER_PROFILE_ANALYSIS.md

# Harvest from brainstorm
./router.sh harvest AGENT_NAMING_BRAINSTORM.md

# Harvest from UX analysis
./router.sh harvest UX_ANALYSIS_THREE_MAIN_AGENTS.md

输出：

• 已创建的上下文文件路径
• 节省的空间（原始文件与提取后文件的对比）
• 内容结构
• 已更新的导航文件
• 如何使用新上下文

---

操作 4：EXTRACT

用途：从上下文文件中提取特定信息

适用场景：

• 需要从上下文中获取特定信息
• 创建摘要或报告
• 为子 Agent 构建上下文包
• 验证上下文是否完整

语法：

extract [file] [what-to-extract]

示例：

# Extract naming conventions
./router.sh extract code-quality.md "naming conventions"

# Extract test patterns
./router.sh extract test-coverage.md "test patterns"

# Extract all standards
./router.sh extract ".opencode/context/core/" "all standards"

输出：

• 按主题整理的提取信息
• 来源文件引用
• 相关性评分
• 使用建议
• 后续步骤

---

操作 5：COMPRESS

用途：压缩大型上下文文件，以节省空间

适用场景：

• 上下文文件非常大（>100 KB）
• 需要减少磁盘空间占用
• 归档旧上下文
• 准备用于分发的上下文

语法：

compress [target] [size-threshold]

示例：

# Compress large files
./router.sh compress ".opencode/context/" "100 KB"

# Compress all context
./router.sh compress ".opencode/context/"

# Compress and archive
./router.sh compress ".opencode/context/development/" "50 KB"

输出：

• 已压缩文件的路径
• 节省的空间（压缩前后对比）
• 压缩率
• 解压说明
• 清单更新

---

Operation 6：ORGANIZE

用途：按关注点（正在处理的事项）而非功能重新组织上下文文件

使用时机：

• 上下文分散在多个位置
• 需要按关注点／主题重新组织
• 创建新的上下文结构
• 整合相关上下文

语法：

organize [target]

示例：

# Organize by concern
./router.sh organize ".opencode/context/"

# Organize specific topic
./router.sh organize ".opencode/context/development/"

输出：

• 当前结构分析
• 提议的新结构
• 移动并重新组织的文件
• 更新的引用
• 导航更新
• 新结构概览

---

Operation 7：CLEANUP

用途：清理过时的、临时的或未使用的上下文文件

使用时机：

• 移除临时文件（.tmp/）
• 删除较早的外部上下文（超过 7 天）
• 移除重复的上下文
• 归档未使用的上下文

语法：

cleanup [target] [older-than-days]

示例：

# Cleanup .tmp directory
./router.sh cleanup ".tmp/"

# Cleanup old external context
./router.sh cleanup ".tmp/external-context/" "7"

# Cleanup stale sessions
./router.sh cleanup ".tmp/sessions/" "3"

输出：

• 待删除的文件
• 可释放的空间
• 影响分析
• 恢复说明
• 清单更新

---

Operation 8：PROCESS

用途：提供处理上下文的引导式工作流

使用时机：

• 需要逐步指导来执行上下文操作
• 处理多个上下文文件
• 学习上下文管理工作流
• 自动化上下文处理

语法：

process [goal] [scope]

示例：

# Process authentication context
./router.sh process "organize authentication context" ".opencode/context/development/"

# Process all development context
./router.sh process "organize all development context" ".opencode/context/development/"

# Process external context
./router.sh process "fetch, persist, and reference external context" ".tmp/external-context/"

输出：

• 分步工作流
• 进度指示
• 发现的上下文
• 处理计划
• 执行结果
• 验证结果
• 总结和后续步骤

---

常见工作流

工作流 1：发现与提取

1. discover context for: "authentication"
   → Find all auth-related context

2. extract from: "security-patterns.md" what: "auth patterns"
   → Get specific patterns

3. Show results
   → Ready to use in session

工作流 2：获取与引用

1. fetch external docs for: "Drizzle ORM"
   → Get live documentation

2. Show file paths
   → .tmp/external-context/drizzle-orm/...

3. Reference in session context
   → Add to "## External Context Fetched"

4. Pass to subagents
   → Include in subtask JSONs

工作流 3：收集与组织

1. harvest context from: "ANALYSIS.md"
   → Extract key concepts

2. organize context by: "concern"
   → Restructure for clarity

3. Update documentation
   → Show new structure

4. Delete original summary
   → Clean up temporary files

工作流 4：清理与维护

1. cleanup .tmp/ directory
   → Remove temporary files

2. cleanup external context older than: "7 days"
   → Remove stale external docs

3. Show space freed
   → Provide statistics

4. Update manifest
   → Keep tracking accurate

---

核心原则

1. 延迟加载

• 先发现文件（glob、grep）
• 只加载所需内容（读取特定文件）
• 增量处理（不要加载整个仓库）
• 引用上下文文件，不要重复复制

2. 清晰指导

• 说明每个步骤正在执行的操作
• 显示文件路径和大小
• 提供操作前后的指标
• 建议后续步骤
• 执行破坏性操作前征求确认

3. 上下文引用

• 发现时：注明找到的文件
• 处理时：引用应用的标准
• 组织时：展示使用的模式
• 清理时：说明将移除的内容

4. 安全操作

• 执行破坏性操作前征求确认
• 需要时创建备份
• 操作后验证完整性
• 提供恢复说明

---

文件结构

.opencode/skills/context-manager/
├── SKILL.md                          # This file
├── router.sh                         # CLI router (entry point)
├── CONTEXT_SKILL_QUICK_START.md      # Quick start guide
├── context-manager.md                # Detailed operation guide
└── navigation.md                     # Navigation index

---

集成点

与 ContextScout 集成

• ContextScout 发现上下文文件
• 此技能帮助组织 ContextScout 找到的内容
• 可以收集 ContextScout 结果中的上下文

与 ExternalScout 集成

• ExternalScout 获取外部文档
• 此技能持久化并组织获取的文档
• 操作中可以引用外部上下文

与 TaskManager 集成

• TaskManager 在任务定义中引用上下文
• 此技能确保上下文文件存在且有效
• 可以编目哪些任务使用了哪些上下文

与其他子 Agent 集成

• 所有子 Agent 都依赖上下文结构
• 此技能维护并验证上下文
• 可以识别子 Agent 所需的上下文缺口

---

成功标准

满足以下条件即表示成功： ✅ 高效发现上下文文件 ✅ 获取并持久化外部文档 ✅ 从摘要中收集上下文 ✅ 清晰提取关键信息 ✅ 安全压缩大型文件 ✅ 按关注点组织上下文 ✅ 安全清理过时文件 ✅ 在每个步骤为用户提供清晰指导 ✅ 所有操作均可撤销 ✅ 更新文档

---

提示与最佳实践

1. 定期发现

定期运行发现操作，以了解上下文结构并找出缺口。

2. 按关注点组织

按正在处理的事项（身份验证、测试等）组织上下文，而不是按功能（标准、指南）组织。

3. 延迟加载外部文档

仅在需要时获取外部文档，不要提前获取。

4. 汇总摘要

使用 harvest 将临时分析文档转化为永久上下文。

5. 定期清理

安排定期清理操作，移除过时的临时文件。

6. 修改后验证

进行修改后，务必验证上下文完整性。

7. 文档组织

整理上下文时，确保 navigation.md 文件保持最新。

8. 引用规范

提取上下文时，务必引用源文件。

---

故障排除

“未找到上下文文件”

运行 discover all context files，查看现有文件及其位置。

“获取外部文档失败”

检查库名称是否正确，以及 ExternalScout 是否可用。

“汇总创建了空文件”

源文件可能缺少足够的高价值内容。请检查并手动补充。

“组织失败”

检查所有引用的文件是否存在，以及 navigation.md 是否有效。

“清理删除了过多内容”

检查备份 .backup/cleanup-{date}.tar.gz 以进行恢复。

---

上下文管理器技能 - 发现、组织和维护项目上下文！