上下文状态检查技能（context-status）：一条命令看清上下文用量与压缩前保留状态
- 一条命令完成体检：在会话中输入
/context-status，即可看到上下文使用估计、自动压缩是否接近、活动计划、最新会话日志与保留状态。 - 四类信息聚合输出：上下文使用估计、活动计划、会话日志、保留状态，按统一格式一次性汇报，无需自己翻目录。
- 只读、轻量、无需联网：核心动作是读取本地缓存与
quality_reports目录下的文件，再格式化输出，不修改任何业务文件。 - 估算不等于精确计量：上下文百分比基于工具调用次数估算，实际压缩由 Claude Code 自动触发，详情中已明确说明。
- 适合长任务与多轮会话：尤其是那种"压缩一次就丢掉半天背景"的深度开发、写作与调研场景。
该技能叫什么？如何下载安装 AI 技能提升开发效率？
基本信息
| 项目 | 内容 |
|---|---|
| 技能中文名 | 上下文状态检查技能 |
| 技能英文名 | context-status |
| 技能 ID | 13626 |
| 触发方式 | 会话内输入 /context-status |
| 作者/来源 | Claude Code Academic Workflow |
| 版本 | 1.0.0 |
它解决什么问题
长时间使用 AI 编程助手的人几乎都遇到过三类困扰：
- 不知道上下文还剩多少：聊到一半突然被自动压缩，之前反复解释的需求、约定和约束全部"蒸发"。
- 压缩后不知道该保留什么：模型压缩的是对话，但真正关键的是当前计划文件、会话日志和记忆文件，这些内容是否已经落盘、压缩后能否恢复，用户往往心里没底。
- 状态分散在各处：计划在一个目录、日志在另一个目录、上下文缓存又在别处，每次想知道"我现在做到哪一步了"，都要手动翻好几个位置。
context-status 的定位非常明确：它是一个"会话健康检查"入口。它把上下文使用估计、当前活动计划、最新会话日志、压缩后的保留状态这四件事，压缩成一段可直接阅读的状态报告。它的价值不是"帮你写代码"，而是让你在做长任务时心里有数，在自动压缩发生之前，把该保存的东西保存好。
"一键安装"的思路与步骤
AI 技能提升开发效率的核心逻辑，是把重复的状态检查动作固化成一条命令，而不是每次手动敲一堆 ls、cat。安装思路如下：
- 确认前提：你已经在使用支持技能（Skill）机制的 Claude Code 环境，并且对自己的用户目录有读写权限——因为该技能需要读取
~/.claude/sessions/*/context-monitor-cache.json以及项目下的quality_reports/目录。 - 获取技能包：从技能市场、团队内部分发渠道或作者提供的仓库获取
context-status技能文件（版本 1.0.0）。具体下载地址与分发方式请以官方说明为准。 - 放入技能目录：将技能按其规范放入 Claude Code 的技能存放位置。本技能的详情中未给出具体安装路径与安装命令，请以官方说明为准，不要凭猜测修改全局配置。
- 重新加载/新开会话：让环境重新扫描技能列表，确保
/context-status命令可被识别。 - 验证是否生效：在任意会话中输入
/context-status，若能看到以「📊 会话状态」开头的格式化报告（包含上下文使用、自动压缩、活动计划、会话日志、保留检查五个区块），即说明安装成功。若提示命令不存在，优先检查技能是否被正确加载、名称是否拼写为context-status。
提示：该技能属于"只读型"辅助技能，不涉及数据上传，也不改变项目文件，安装后可以先在测试项目里跑一次，确认输出符合预期再用于正式项目。
该技能的主要功能和特点
主要功能
- 上下文使用估计：给出上下文窗口使用的近似百分比，让你对"还剩多少余量"有直观判断。
- 自动压缩紧迫度提示：以「接近 / 不紧迫」两档状态，提示是否需要立刻做状态保存动作。
- 活动计划定位：列出
quality_reports/plans/下最新的计划文件（按时间倒序取前几个），并汇报该计划的当前状态（草稿 / 已批准 / 进行中 / 已完成）以及当前未检查任务。 - 会话日志定位：列出
quality_reports/session_logs/下最新的一份会话日志，方便你回溯"上一次做到哪"。 - 保留状态检查：检查压缩前钩子（压缩前保存）与压缩后恢复是否已配置，并明确告知"会话状态将在压缩前保存"这一行为是否成立。
- 统一格式化输出：所有信息以固定排版呈现，字段稳定、可快速扫读，也便于粘贴到交接文档里。
和普通做法比，强在哪
- 聚合而非分散：普通做法需要分别执行
cat缓存、ls计划目录、ls日志目录，还要自己判断哪个是最新的；该技能一次调用完成全部检索与排序。 - 有判断，不只是罗列：它不只告诉你文件在哪，还告诉你压缩"接近还是不紧迫"、保留机制"已配置还是缺失"，直接把结论摆出来。
- 零侵入：只读缓存与报告文件，不写入、不修改、不删除，风险极低。
- 依赖极少：核心依赖是本地文件系统与约定的目录结构，不需要额外服务、账号或网络。
- 可复用：本质上把"会话健康检查"这件事变成了可重复执行的标准动作，而不是依赖个人经验。
如何使用该技能？
步骤 1：进入目标会话
在正在进行任务的 Claude Code 会话中操作。该技能读取的是"当前会话"相关状态，因此在新开的空会话中检查，参考价值有限。
步骤 2：调用命令
在输入框中输入：
/context-status
步骤 3：读取输出（四个区块）
技能会按固定格式汇报，形如：
📊 会话状态
─────────────────────────────────
上下文使用: ~XX% (估计)
自动压缩: [接近 | 不紧迫]
📋 活动计划
文件: quality_reports/plans/YYYY-MM-DD_description.md
状态: [草稿 | 已批准 | 进行中 | 已完成]
任务: [当前未检查任务或"无"]
📝 会话日志
文件: quality_reports/session_logs/YYYY-MM-DD_description.md
✓ 保留检查
• 压缩前钩子: [已配置 | 缺失]
• 压缩后恢复: [已配置 | 缺失]
• 会话状态将在压缩前保存
步骤 4：按结果采取动作
- 若显示"自动压缩：接近"，建议立刻把当前进展写进计划文件或会话日志，确保关键决策已落盘。
- 若"压缩前钩子：缺失"，说明自动保存机制未配置，需要手动补齐状态保存动作，具体配置方式以官方说明为准。
- 若活动计划状态是"草稿"，而你已经实际开工，记得同步状态，避免下次接手时误判。
步骤 5：理解背后的取数逻辑（便于排查）
该技能的工作流程共四步，均为本地读取：
cat ~/.claude/sessions/*/context-monitor-cache.json 2>/dev/null | head -20
ls -lt quality_reports/plans/*.md 2>/dev/null | head -3
ls -lt quality_reports/session_logs/*.md 2>/dev/null | head -1
前三步取数，第四步格式化输出。因此当输出出现"无"或为空时，通常是缓存文件尚未生成，或项目里还没有对应的计划/日志目录——这属于数据缺失，不是技能故障。
输入输出示例
- 输入：
/context-status - 输出要点：
上下文使用: ~62% (估计)、自动压缩: 不紧迫、活动计划: quality_reports/plans/2025-03-11_refactor-auth.md，状态: 进行中、会话日志: quality_reports/session_logs/2025-03-11_refactor-auth.md、压缩前钩子: 已配置。 - 你可以直接把这整段报告粘贴进交接文档或群聊，作为"当前进度快照"。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势 | 不足 |
|---|---|---|---|---|---|---|
| context-status（本技能） | 会话健康检查专用技能 | 上下文使用估计、压缩紧迫度、活动计划、会话日志、保留状态五项合一 | 低：安装技能后一条 /context-status 命令，无额外依赖 |
长任务中途体检、压缩前风险排查、任务交接 | 输出结构化、含保留状态判断、只读零侵入、可粘贴复用 | 上下文百分比为估算值；依赖约定目录结构，目录缺失时信息为空 |
| Claude Code 内置状态/成本类命令 | 平台原生信息查询 | 展示会话与用量相关的原生信息 | 极低：无需安装 | 快速查看会话基本情况 | 无需配置、随平台更新 | 侧重通用信息，通常不覆盖"计划文件 + 会话日志 + 压缩保留"这条链路 |
| 手动查看本地目录 | 纯手工运维 | 自行 cat 缓存、ls 计划与日志目录 |
中：需要记住路径与命令 | 偶尔检查、排查问题 | 完全可控、无学习成本前提 | 重复劳动多、易漏项、无"接近压缩"判断、不适合高频使用 |
| 第三方会话管理/上下文压缩类工具 | 会话与上下文治理 | 上下文监控、压缩策略、会话归档等 | 中到高：通常需要配置钩子或额外集成 | 团队级上下文治理、复杂工作流 | 能力更全面、可自动化 | 配置成本高、可能与既有工作流冲突，具体能力以各自官方说明为准 |
选型建议：如果你只是想在长会话里"随时知道自己到哪了"，context-status 的性价比最高；如果你需要团队级的上下文治理与自动化压缩策略，再考虑引入更重的会话管理方案。
该技能的典型应用场景与实际体验情况
场景一：长周期重构任务的中途体检（后端工程师）
痛点：一次重构要跨十几个文件、几十轮对话，最怕压缩后模型"忘了"此前约定的接口契约和禁止改动的模块。
用法：每完成一个子任务就执行一次 /context-status，看到"自动压缩：接近"就先补齐计划文件里的任务清单，再继续。
实际体验：上手难度极低，几乎零学习成本；输出稳定、扫一眼就能决策。需要注意的是，它给的是估算百分比，不要把它当作精确计量工具，而是当作"该不该保存状态"的信号灯。
场景二：多轮学术写作与资料整理（研究者 / 学生）
痛点：写作过程中会不断补充文献、调整论点，压缩后容易丢失论证链条。
用法：把每次的状态报告粘贴到写作笔记里，配合 quality_reports/session_logs/ 下的日志，形成"进度时间线"。
实际体验：效果主要体现在"可回溯"上——事后想复现某次决策的上下文时有据可查。注意该技能本身不会替你写日志，日志需要你在流程中主动产出。
场景三：任务交接与复盘（团队协作）
痛点：把任务交给同事或另一个会话时，口头描述进度容易失真。
用法：交接前跑一次 /context-status，把报告里的计划文件路径、状态、日志文件路径一并贴进交接说明。
实际体验：交接信息从"我觉得快做完了"变成"计划状态为进行中、日志在某某路径"，沟通成本明显下降。注意报告里的路径是相对路径，跨机器交接时要说明清楚。
场景四：压缩保留机制的自检（工作流维护者）
痛点：配置了压缩钩子，但不确认是否真的生效。
用法：定期执行命令，重点看"保留检查"区块中的"压缩前钩子 / 压缩后恢复"是否显示为已配置。
实际体验：这是该技能最有差异化的一环——把"看不见的配置"变成"看得见的状态"。注意事项：技能只做检查与提示，具体钩子的配置与修复仍需按官方文档操作。
该技能能为用户带来的价值
效率层面：把原本需要三条以上命令、还要人工判断"哪个文件最新"的检查动作，压缩成一条命令、一次输出。按每天检查 5 次计算，节省的是零碎但高频的上下文切换成本。
风险层面：上下文溢出导致的返工，往往是"重新解释半小时需求"级别的损失。通过"接近压缩"提示，你可以把保存状态的动作提前到压缩发生之前，把不可控的丢失变成可控的落盘。
门槛层面：不需要理解缓存文件结构、不需要记住目录约定，新手也能读懂"上下文使用 ~62%、自动压缩不紧迫、压缩前钩子已配置"这样的结论，把经验型的会话管理变成人人可用的标准动作。
长期价值：它推动团队形成"计划文件 + 会话日志 + 记忆文件三层落盘"的习惯。当所有重要状态都写入磁盘，会话压缩就只是一次"内存回收"，而不是一次"记忆清空"。随着会话越来越长、任务越来越复杂，这种习惯带来的复利会越来越明显。
常见问题 FAQ
Q1：context-status 怎么安装？
A：先确认你的环境支持技能机制并能读取本地用户目录，再从官方或团队渠道获取该技能（版本 1.0.0）并放入技能目录，重新加载后输入 /context-status 验证。详情中未提供具体安装路径与命令，请以官方说明为准。
Q2：这个技能收费吗？
A：技能详情中没有提及任何收费信息，请以官方说明为准。需要强调的是，它本身只读取本地缓存与项目目录文件，不涉及外部服务调用。
Q3：显示的上下文百分比准确吗？
A：不精确。详情明确说明，上下文百分比是基于工具调用次数的估计值，实际压缩由 Claude Code 自动触发。建议把它当作趋势与预警信号，而不是精确计量。
Q4：它和直接手动查看目录有什么区别？
A：手动方式能拿到同样的原始信息，但要自己记路径、自己排序、自己判断"是否接近压缩"“钩子是否配置”。该技能把这些判断环节一并做了，并输出统一格式，更适合高频使用与交接粘贴。
Q5：输出里计划和日志显示为空，是坏了吗？
A：通常不是。技能通过查找 quality_reports/plans/*.md 与 quality_reports/session_logs/*.md 取数，若项目里还没有对应目录或文件，或 ~/.claude/sessions/*/context-monitor-cache.json 尚未生成，就会显示为空。先确认目录约定，再判断是否异常。
Q6：适合谁用？
A：适合使用 Claude Code 进行长周期开发、写作、调研的用户，尤其是经常遇到"压缩后丢上下文"、需要跨会话接续任务、以及需要向他人交接进度的人。若只是短问答式使用，收益相对有限。