Codex 周度使用复盘

要解决什么问题

用 Codex 做项目时，会话散落在主线程、辅助线程和各类产物里，事后很难回答：这周到底花了多久、做了哪些交付、Prompt 哪里总在返工。外部分析服务也不适合承载完整会话与密钥。这个技能把最近一段时间的使用记录整理成本地 HTML 报告，按项目归并，而不是聊天流水账。

技能如何工作

执行原则是只读扫描：不删改会话、缓存、项目文件、报告或 skills；中间数据与报告留在本机。流程大致如下：

1. 扫描：默认最近 7 天（可按用户指定范围）。优先跑仓库内脚本，覆盖 Codex 主会话、辅助线程、时间戳与 Token 事件，以及工作区新增/修改的文档、代码、表格、网页、图片等；同时关注 skill 变更与同类自动化任务状态。扫描 JSON 不写完整原始 Prompt、密钥、Token 或多余绝对路径。
2. 归并项目：读取 references/project-grouping.md，按证据强弱把会话与产物归到一个项目；同一产物只归属一处，证据不足时用中性任务类型，不编造项目名。
3. 分析：每个主要项目复盘做了什么、投入多久、形成哪些产物；检查首条请求是否交代交付物、输入、范围与验收；后续是否反复补「不要做什么」；重复劳动是否值得沉淀为模板、脚本或 skill。
4. 生成报告：按 references/report-design.md 模板输出 HTML，默认自动打开浏览器（仅在你要求静默或只生成文件时用 --no-open）。正文顺序从「本周结论」到「可复用机会」，颜色说明放在右上角按钮，异常才折叠展示诊断信息。
5. 自动化：若你要求每周定期复盘且尚无同类任务，通过 Codex 自动化工具创建（默认每周一 09:30），不手改配置文件；已有任务则只汇报状态。

对话交付时只给一句话结论、总时长/主要项目/Token 粗算、1～3 条习惯建议、报告路径与自动化状态；细节在 HTML 里。

适用边界与注意点

• 时间与 Token 为本地记录估算，无法精确时会说明口径，不编造。
• 面向普通使用者：不堆内部调试术语；辅助线程与明显系统测试不计入主要使用时长。
• 若大部分内容落入「其他任务」，应先检查解析与归并，而不是直接交正式报告。
• 异常处理参考 references/troubleshooting.md；报告未自动打开时要区分「文件已生成」与「浏览器打开失败」。