名称: ctx-agent 描述: “加载完整上下文数据包。在会话开始时或上下文看起来过时或不完整时使用。” 允许的工具: Bash(ctx:*)
为AI消费加载完整的上下文数据包。
何时使用
- 在会话开始时加载所有上下文
- 当上下文看起来过时或不完整时
- 当在不同工作领域之间切换时
何时不使用
- PreToolUse钩子已经自动运行
ctx agent并带有冷却时间 — 你很少需要手动调用它 - 如果在本会话中已经加载了上下文,不要仅仅为了“刷新”而运行它
加载后
阅读“阅读这些文件(按顺序)”中列出的文件 — 数据包是摘要,不能替代原文件。特别是,在编写任何代码之前,请阅读CONVENTIONS.md。
向用户确认:“我已阅读所需的上下文文件,并遵循项目约定。” 在完成此操作之前,不要开始实施。
标志
| 标志 | 默认值 | 描述 |
|---|---|---|
--budget |
8000 | 上下文数据包的令牌预算 |
--format |
md | 输出格式: md 或 json |
--cooldown |
10m | 在此持续时间内抑制重复输出 |
--session |
(无) | 用于冷却隔离的会话ID (例如 $PPID) |
执行
ctx agent $ARGUMENTS
示例 — 默认加载:
ctx agent
示例 — 为有限上下文提供较小的数据包:
ctx agent --budget 4000
示例 — 带冷却时间 (PreToolUse钩子如何调用它):
ctx agent --budget 4000 --session $PPID
示例 — 用于编程使用的JSON格式:
ctx agent --format json --budget 8000