名称: ctx-status 描述: “显示上下文摘要。在会话开始时使用，或在不确定当前项目状态时使用。” 允许的工具: Bash(ctx:*)
显示当前上下文状态：文件、令牌预算、任务以及近期活动。
何时使用
- 在会话开始时，以便在开始工作前了解情况
- 当不清楚正在处理什么或存在什么上下文时
- 检查令牌使用情况和上下文健康状况
- 当用户询问“项目状态如何？”时
何时不使用
- 当你已通过当前会话中的
/ctx-agent加载了上下文时（状态信息是代理提供信息的子集） - 在同一会话中反复使用，且期间没有变化
使用示例
/ctx-status
/ctx-status --verbose
/ctx-status --json
标志
| 标志 | 简写 | 默认值 | 用途 |
|---|---|---|---|
--json |
false | 以 JSON 格式输出（用于脚本处理） | |
--verbose |
-v |
false | 包含文件内容预览 |
显示内容
输出包含三个部分：
1. 概览
- 上下文目录路径
- 文件总数
- 令牌估算（对所有
.context/*.md文件求和）
2. 文件
.context/ 目录下的每个 .md 文件，附带：
| 指示符 | 含义 |
|---|---|
| 勾选 | 文件有内容（已加载） |
| 圆圈 | 文件存在但为空 |
文件特定摘要：
CONSTITUTION.md: 约束条件数量TASKS.md: 活跃和已完成任务数量DECISIONS.md: 决策数量GLOSSARY.md: 术语数量- 其他文件: “已加载” 或 “空”
使用 --verbose 时：为每个文件添加令牌计数、字节大小和 3 行内容预览。
3. 近期活动
最近修改的 3 个文件，附带相对时间戳（例如，“5 分钟前”、“2 小时前”）。
执行
ctx status
运行后，为用户总结要点：
- 还剩多少活跃任务
- 是否有任何上下文文件为空（可能需要填充）
- 令牌预算使用情况（上下文是精简还是臃肿？）
- 最近修改了什么（了解工作进展）
结果解读
| 观察结果 | 建议 |
|---|---|
| 许多空文件 | 上下文稀疏；填充核心文件（TASKS, CONVENTIONS） |
| 令牌计数高（>30k） | 考虑使用 ctx compact 或归档已完成的任务 |
| 近期无活动 | 上下文可能过时；检查文件是否需要更新 |
| TASKS.md 有 0 个活跃任务 | 所有工作已完成，或需要添加新任务 |
质量检查清单
运行状态后，请验证：
- [ ] 已为用户总结了输出（不要仅转储原始输出而不加评论）
- [ ] 标记了应填充的任何空核心文件
- [ ] 如果令牌预算看起来过高或过低，已予以注明