ai-wiki-codex-daily - SKILL.md Agent Skill

name: ai-wiki-codex-daily description: 为本 AI wiki 生成按日维度的 Codex 使用日报。用户要求 Codex 日报、今日 Codex 总结、session 复盘、交互复盘、workflow/harness 改进分析，或要求写入 human/inbox/codex-daily 时使用。

AI Wiki Codex 日报

概览

从 Codex thread/session 生成一篇“事实 + 轨迹 + 洞察 + 交互批评 + 启发”的日报。用公开 thread 工具发现候选工作，用本机 group timeline 读取完整事实；公开工具不足时不要阻塞日报。

输出是一篇 inbox 笔记：human/inbox/codex-daily/YYYY-MM-DD_{title}.md。使用 human/inbox 的 inbox_status frontmatter 规则；不要自动 ingest 到 human/sources，不要自动更新 index.md 或 log.md。

工作流

确定目标日期、标题和输出路径。
- 默认日期：当前本地日期，默认标题：Codex日报。
- 输出路径：human/inbox/codex-daily/YYYY-MM-DD_{title}.md。
发现候选 thread。
- 如果 thread 工具未加载，先通过 tool discovery 搜索 list_threads。
- 用 list_threads 获取当天相关 thread 的标题、preview、状态、cwd、创建/更新时间。

读取 group timeline。先看输出里的 parent_workflows，再按其中列出的 group ids 读取阶段事实。

# 输出 yaml
python3 .codex/skills/ai-wiki-codex-daily/scripts/collect_session_facts.py \
  --date YYYY-MM-DD

按 group 读取事实：

# 输出 yaml
python3 .codex/skills/ai-wiki-codex-daily/scripts/collect_session_facts.py \
  --date YYYY-MM-DD \
  --group-id <group-id>

从 parent workflow 和 group 提炼事实：用户请求、最后状态、agent/subagent 编排、关键轨迹、产物、未解决问题和下一步。关键轨迹要覆盖重要探索、决策、转向、失败、验证、收尾，以及可观测的上下文压缩事件；不要把弱信号推断成压缩事件。
写作前横向比较当天 parent workflows 和 groups：不要按固定栏目凑结论，先找最值得解释的张力点、转折、失败修正、反事实风险和用户纠偏。优先问“为什么今天会这样”“如果没有这个验证或纠正会留下什么隐患”“这会改变 Agent 下次怎么做”。同时单独审视用户和 Codex 的交互逻辑：哪些互动方式放大了返工、误判、无效探索或过度发散；如果没有明显问题，也可以明确写“当天未见显著交互缺陷”。日报正文默认按 parent workflow 归并，再按 group/stage 展开；没有父线程的独立 session 再单列。
读取 references/daily-note-template.md 后写日报正文。正文由 Agent 基于事实取舍和复盘，不机械填模板；超长 worker prompt 只摘要任务、约束、写入范围和输出要求。目标文件已存在时，不要静默覆盖，除非用户明确要求 refresh。

日报质量标准

frontmatter 必须包含 type: codex-daily、ingest_policy: on-request、inbox_status: unread、inbox_created_at、inbox_read_at、raw_path、ingested_at 和 archive_reason。
Source Manifest 必须列出公开 thread 工具使用情况、读取过的 parent workflow ids、group ids、fallback 来源和覆盖限制。
工作日报（对上汇报） 必须以 Codex 使用者或团队工作口吻写，面向上级同步进展、结果、风险和下一步；避免暴露过多 agent/thread/tool 内部细节。
Session 明细 必须包含用户输入、最后状态、关键轨迹、产物和下一步。
分析与洞察 要跨 session 提炼当天最有解释力的模式、矛盾、风险或有效做法；先解释事实背后的机制，再落到会改变下次行为的判断，不要机械填满固定栏目。
对用户/Codex 交互的批评 必须基于当天的具体交互证据，判断用户/Codex 的互动方式是否放大了返工、误判、无效探索或过度发散，不顺应结果做事后合理化。需要指出更好的问法或协作方式；如果当天没有明显问题，可以明确写“未见显著交互缺陷”。
启发与下一步 要把洞察转成少量高价值行动选择，说明它来自哪个摩擦或失败信号、要改变什么工作方式、下次什么触发条件启用；流程沉淀、知识补齐、研究线索只在确有高价值时提出。
不要粘贴完整 transcript、完整命令输出或冗长工具日志。
不要把日报当作 canonical source note；只有用户明确要求 ingest 时，才进入 human/sources。

辅助脚本

列出 group：

python3 .codex/skills/ai-wiki-codex-daily/scripts/collect_session_facts.py \
  --date YYYY-MM-DD

读取单个 group：

python3 .codex/skills/ai-wiki-codex-daily/scripts/collect_session_facts.py \
  --date YYYY-MM-DD \
  --group-id source-links-repair-workers

该脚本只用于提供事实时间线，不负责写日报正文。默认输出为 Agent 写日报可直接阅读的 YAML/Markdown。

参考

references/daily-note-template.md：inbox 日报的通用结构，供 Agent 写作时参考。