用途：在行动前用 ctx 检索本地编码智能体会话记录。这些记录可能包含用户意图、决策、先前工作、尝试以及成功或失败的经验。两种使用模式：一是工作前的检索，二是当用户要求对历史主题做跨会话研究时写只读报告。
前置条件：需要安装并配置 ctx CLI。若缺失且安装工具合适，可执行 curl -fsSL https://ctx.rs/install | sh。首次设置可能因索引历史会话而耗时，可放后台或 tmux 中运行。若 ctx 仍不可用，应说明本地历史搜索不可用，不得编造结果。
用法：冷启动时先确认就绪，运行 ctx status 与 ctx sources；仅在脚本需要精确字段时加 --format json。优先用自然语言搜索：ctx search "<query>"，可按需添加过滤条件，如 --refresh off、--provider codex、--workspace <workspace>、--file <path>、--since 30d、--term "<related term>"、--session <ctx-session-id>、--verbose。默认文本输出适合智能体阅读，搜索和 show 不加 --format json，除非管道给 jq、脚本或需要精确机器字段，因为 JSON 输出更大、易消耗上下文。
默认搜索返回主智能体会话；当实现细节、代码审查、测试输出或失败轨迹可能重要时用 --include-subagents。需要完整 ID、引用和可复制后续命令时用 --verbose。可用 ctx show session <ctx-session-id> --format markdown --out /tmp/ctx-session.md 写临时文件，配合 wc -c 查看大小后读取相关部分。在 Codex 中，当 CODEX_THREAD_ID 存在时，ctx 默认排除当前会话树，避免当前提示与子智能体主导历史检索；仅在目标就是当前会话树时用 --include-current-session。
依赖结果前先检查：ctx show event <ctx-event-id> --window 5、ctx show session <ctx-session-id>，以及用 ctx locate event / ctx locate session 定位原始提供方材料（provider_session_id 是 Codex 恢复 UUID）。需要缩小搜索时，可变换查询并组合 --events、--session、--include-subagents、--refresh off 等，配合 show、locate。搜索结果窗口有限，不得据返回命中数声称语料库级精确计数或完整审计；无法支撑结论时应说明限制并报告最强证据。高级查询或完整确定事件枚举可用 ctx list events，先阅读 ctx docs show event-queries。
历史研究报告：除非用户还要求编辑，否则保持只读，由智能体撰写报告，ctx 只负责检索本地材料。应复述主题、范围与期望长度，默认简洁，用户要求时间线、备选方案或详细证据时才写长报告。运行多次有针对性的搜索，变换用户措辞、文件或模块名、错误文本、命令、分支名和决策词，先用 ctx search "<topic>"，再用 --term 扩大或用 --workspace、--provider、--file、--since、--session 缩小；评审、实现尝试、测试输出或失败轨迹可能位于委派会话时加 --include-subagents；报告不得更新本地索引时加 --refresh off。结论前用 ctx show event 查看命中及邻近轮次、ctx show session 查看整段会话。跨会话比较证据，记录一致、冲突、过时结果与缺口。以智能体综合结论加引用输出：简洁报告含答案、最强 ctx ID、注意事项或缺口；长报告含问题范围、检索方法、发现或时间线、证据表（provider、ctx session ID、ctx event ID、来源重要性）、冲突缺口与后续建议。
引用规则：当 ctx 材料影响回答或实现时应引用，包含 provider、ctx session ID、ctx event ID（可用时）、provider session ID（可用时）。跨多条摘要综合时标注为综合结论并引用支撑片段。所引事件或会话不在当前 Core 生成中时应说明，并考虑是否需显式执行 ctx import。
安全规则：智能体阅读优先文本输出；仅脚本、jq 或精确字段提取用 JSON，且保持小体积。引用文本未明确说明时不得称 ctx 推断出某决策，不得称 ctx 撰写了模型分析。不得把原始记录、大型 JSON、密钥、令牌或私有路径粘贴到面向用户的报告中，应总结证据、仅引用支撑结论所需的短片段。~/.ctx、提供方记录路径与 JSON 输出视为私有本地历史，除非用户明确要求分享经审查的摘录。