用途
idea-memo-writer 是一个研究工作流技能，用于将已经存在的候选研究想法清单（shortlist）综合成一份可直接用于讨论的研究方向头脑风暴备忘录（brainstorm memo）。它的目标是产出最终的、面向读者的头脑风暴交付物，供 PI 或 PhD 讨论使用。
主要能力
- 把 shortlist 转化为讨论就绪的备忘录。
- 生成以下输出文件：
- output/REPORT.md
- output/APPENDIX.md
- output/REPORT.json
- 最终备忘录的定位是：
- 面向导师的讨论备忘录，而不是工作流笔记；
- 证据钩子（evidence hooks）和附录阅读指南具体到论文；
- 明确说明排序逻辑（rank logic）和快速排除标准（quick kill criteria）；
- 仍然是一份强有力的头脑风暴产物，根植于文献，内容足够丰富以支撑 PI/PhD 讨论，但不固化为刚性的项目执行规范。
触发与路由
触发词包括：idea memo、brainstorm memo、research direction memo、report md、研究备忘录、brainstorm report。
使用时机：当 shortlist 已存在，并且需要产出最终的、面向读者的头脑风暴交付物用于 PI / PhD 讨论时使用。
加载顺序
始终读取：
- references/overview.md
- references/report_structure.md
脚本边界
脚本仅在以下场景使用 scripts/run.py：
- 从 trace 产物进行确定性的报告组装；
- 调用 tooling/ideation.py 库函数进行渲染。
不应将 run.py 视为以下内容的所在之处：
- 构思启发式（ideation heuristics）或评分逻辑；
- 硬编码的报告文字模板。
使用方式
快速开始：
uv run python .codex/skills/idea-memo-writer/scripts/run.py --workspace <workspace>
全部选项：
- --workspace <dir>（必填）
- --unit-id <U###>
- --inputs <semicolon-separated>
- --outputs <semicolon-separated>
- --checkpoint <C#>
示例（为一个工作区组装头脑风暴备忘录）：
uv run python .codex/skills/idea-memo-writer/scripts/run.py --workspace workspaces/brainstorm-llm-agents
适用场景
适用于已有 shortlist、需要最终读者可见的头脑风暴备忘录的研究工作流，尤其是用于 PI / PhD 讨论的场景。
限制
资料未提供关于收费、价格、平台依赖、性能或效果的信息；这些方面暂未提供。