使用AutoSkill Reflection CLI生成过去Codex会话历史的反思。 这项技能有助于揭示重复的模式、摩擦以及潜在的技能想法，从中获得 之前的Codex对话。

包含了什么

• SKILL.md：关于何时以及如何使用该技能的指导
• scripts/：CLI工具（reflect_sessions.py和辅助工具）
• references/：命令目录、使用说明及示例

要求

• Python 3.11+
• ~/.codex/sessions 中的本地 Codex 会话档案
• 你的PATH（或通过--codex-path）上的codex二进制）

快速开始

从scripts/执行命令：

人类可读输出：

项目过滤器示例：

预设提示示例：

内嵌提示示例：

提示预设

可用预设：

• reflection（默认）：对重复、摩擦和技巧理念的全面反思
• summary：目标、行动、输出和决策的简明总结
• bloat：游戏中引入的臃肿/死胡同/清理机会
• incomplete：开放循环和未完成任务
• decisions：关键决策、替代方案及理由
• next_steps：具体的后续行动、测试和验证

Codex Reflect Skill

Generate reflections for past Codex session histories using the AutoSkill Reflection CLI. This skill helps surface repeated patterns, friction, and potential skill ideas from prior Codex conversations.

What’s included

• SKILL.md: guidance on when and how to use the skill
• scripts/: the CLI tools (reflect_sessions.py and helpers)
• references/: command catalog, usage notes, and examples

Requirements

• Python 3.11+
• A local Codex session archive in ~/.codex/sessions
• The codex binary available on your PATH (or pass --codex-path)

Quick start

Run commands from scripts/:

python3 reflect_sessions.py --output -

Human-readable output:

python3 reflect_sessions.py --output-style human --output -

Project filter example:

python3 reflect_sessions.py --project ExampleProject --output -

Preset prompt example:

python3 reflect_sessions.py --prompt-preset summary --output -

Inline prompt example:

python3 reflect_sessions.py --prompt-text "Summarize in 5 bullets." --output -

Prompt presets

Available presets:

• reflection (default): full reflection on repetition, friction, and skill ideas
• summary: concise summary of goals, actions, outputs, and decisions
• bloat: bloat/dead ends/cleanup opportunities introduced during the session
• incomplete: open loops and unfinished tasks
• decisions: key decisions, alternatives, and rationale
• next_steps: concrete follow-up actions, tests, and validations

Use --prompt-preset , --prompt-text "", or --prompt-file /path/to/prompt.md.

Cache behavior

Reflections are cached per session and prompt. Cache files live here:

~/.codex/sessions/reflection_cache/-.json

prompt_key is a short hash derived from the prompt label (preset path or inline: for inline prompts). Legacy cache files without the prompt key are still read for the default reflection preset.

Notes on privacy

The CLI reads local session histories from ~/.codex/sessions. Reflections may contain sensitive content from those sessions. Review outputs before sharing them publicly.

License

MIT. See LICENSE.