advisor-update-writer

Advisor Update Writer

撰写简洁的研究进展更新，帮助导师、指导者、合作者或实验室听众做出决策。

在以下情况下使用此技能：

• 用户需要周报、发给导师的邮件、实验室进展更新、会议备忘录或合作者状态说明
• 需要总结实验结果、写作进展、审稿风险或实现阻碍
• 更新需要征求决策、反馈、资源、算力、论文定位建议或优先级选择
• 需要将项目记忆转化为易于阅读的进展报告
• 需要协调多个反馈循环：算法、实验、写作、评审、rebuttal、工件或发布

不要将此技能用于完整的实验报告。当主要产出是详细的技术报告时，请使用 experiment-report-writer。当主要产出是以决策为导向的沟通内容时，请使用此技能。

将此技能与以下技能配合使用：

• research-project-memory，用于恢复当前状态、决策、主张、证据、风险和行动
• experiment-report-writer，用于在需要详细实验依据时提供源报告
• figure-results-review，用于审阅将展示给导师的图表或表格
• result-diagnosis，用于在出现负面或模糊结果时做出决策
• paper-positioning-planner，用于征求有关论文叙事或目标投稿渠道的反馈
• paper-evidence-board，用于同步列出写作和实验方面的待办事项
• work-timeline-planner，用于更新需要回顾性时间线依据的情况

技能目录结构

<installed-skill-dir>/
├── SKILL.md
└── references/
    ├── decision-framing.md
    ├── memory-writeback.md
    └── update-template.md

渐进式加载

• 在起草需保存或事关重大的更新之前，务必先阅读 references/decision-framing.md 和 references/update-template.md。
• 当更新会产生需要长期保留的决策、行动或反馈时，请阅读 references/memory-writeback.md。

核心原则

• 开篇说明自上次更新以来与决策相关的变化。
• 区分事实、解读、风险和请求。
• 不要把请求埋在内容中；明确说明需要导师提供什么意见。
• 将原始实验细节压缩为证据及其含义；需要时链接到详细报告。
• 如果负面结果会影响项目决策，就应纳入更新。
• 会后或收到回复后，将反馈转化为行动并更新记忆。
• 根据受众调整内容：发给导师的更新应直接、以决策为重；实验室更新需要更多背景；合作者说明则需要明确责任归属和交接事项。

步骤 1 - 确定更新类型

选择模式：

• weekly：自上次更新以来的进展、当前阻碍、下周计划
• decision：选项、证据、建议、明确请求
• meeting：议程、讨论要点、待决事项、会后记录
• email：包含背景、状态、请求和附件的简洁消息
• lab：更全面的背景、关键结果，以及受众应记住的内容

明确以下信息：

• 受众和预期篇幅
• 截止时间或会议时间
• 项目阶段
• 自上次更新以来的关键证据
• 尚未解决的决策
• 希望导师采取的行动
• 保存路径（如需创建文件）

如果需要保存但未提供路径，请使用：

docs/updates/advisor_update_YYYY-MM-DD.md

步骤 2 - 收集当前状态

优先使用项目记忆（如有），然后查阅主要文件。

查找：

• memory/current-status.md
• memory/decision-log.md
• memory/claim-board.md
• memory/evidence-board.md
• memory/risk-board.md
• memory/action-board.md
• 实验报告、论文草稿、审稿意见、rebuttal 记录和近期 git 提交

提取：

• 有哪些变化
• 哪些证据支持这些变化
• 哪些事项失败或仍不确定
• 现在需要做出什么决策
• 用户的建议是什么
• 接下来会做什么

步骤 3 - 梳理决策

阅读 references/decision-framing.md。

对于每项决策，请列出：

• 决策问题
• 选项
• 支持和反对各选项的证据
• 延迟决策的风险
• 建议选项
• 向导师提出的具体请求
• 收到肯定、否定或其他答复后的下一步行动

如果不需要做出决策，则围绕进展、风险和下一步行动来组织更新。

第 4 步 - 起草更新

阅读 references/update-template.md。

默认结构：

• 一行状态
• 关键进展
• 证据和解读
• 阻塞因素或风险
• 决策/请求
• 后续行动

对于电子邮件，确保第一段就足以回答“你需要我做什么？”

对于会议记录，如果会议已经结束，请同时包含议程和会后决策。

第 5 步 - 检查更新

定稿前：

• 每个重要主张都有证据支撑，或已标明为解读
• 请求明确
• 阻塞因素都注明负责人或建议的后续步骤
• 如果负面结果会影响方向，则不要隐瞒
• 更新篇幅适合受众
• 已注明附件或链接
• 决策或反馈已准备好写回记忆

第 6 步 - 反馈后写回

如果存在记忆，请阅读 references/memory-writeback.md。

顾问回复后，或会议记录定稿后，更新决策、行动、风险和状态。