SuperAPI AI 工具集

advisor-update-writer

写作与研究

查看项目

更新于 10-13 14:45

技能介绍

用途

advisor-update-writer 用于撰写简洁的研究更新,帮助导师、指导者、合作者或实验室受众做出决策。当用户需要以下内容时使用该技能:每周更新、导师邮件、实验室更新、会议备忘录或合作者状态说明;需要总结实验结果、写作进展、审稿风险或实现障碍;更新中需要请求决策、反馈、资源、算力、论文定位建议或优先级选择;需要把项目记忆转化为人类可读的进展报告;需要协调多个反馈回路,包括算法、实验、写作、审稿、反驳、工件或发布。

该技能不用于完整实验报告。当主要产出是详细技术报告时,应使用 experiment-report-writer;当主要产出是面向决策的沟通时,使用本技能。

主要能力

  • 按更新类型分类:weekly(自上次更新以来的进展、当前障碍、下周计划)、decision(选项、证据、建议、明确请求)、meeting(议程、讨论点、所需决策、会后记录)、email(含背景、状态、请求和附件的简洁消息)、lab(更广背景、关键结果、受众应记住的内容)。
  • 识别受众与预期长度、截止时间或会议时间、项目阶段、自上次更新以来的关键证据、未解决的决策、期望导师采取的行动,以及保存路径。
  • 在需要保存且未给路径时,默认使用 docs/updates/advisor_update_YYYY-MM-DD.md。
  • 收集当前状态:优先使用项目记忆,其次使用主要文件,查找 memory/current-status.md、memory/decision-log.md、memory/claim-board.md、memory/evidence-board.md、memory/risk-board.md、memory/action-board.md,以及实验报告、论文草稿、审稿意见、反驳说明和近期 git 提交。
  • 提取变化内容、支持变化的证据、失败或仍不确定的内容、当前需要的决策、用户建议、下一步安排。
  • 框定决策:对每个决策给出决策问题、选项、各选项正反证据、延迟风险、推荐选项、对导师的明确请求,以及在得到是/否/替代答案后的下一步行动。若无需决策,则围绕进展、风险和后续行动组织更新。
  • 起草更新,默认结构为:一行状态、关键进展、证据与解读、障碍或风险、决策/请求、后续行动。邮件应让第一段就足以回答“你需要我做什么”。会议记录若会议已发生,应同时包含议程和会后决策。
  • 检查更新:每个重要论断都有证据或标注为解读;请求明确;障碍有负责人或拟议下一步;若负结果影响方向则不应隐藏;更新长度适合受众;附件或链接有命名;任何决策或反馈已准备好写回记忆。
  • 反馈后写回:当存在记忆时,在导师回复后或会议记录定稿后更新决策、行动、风险和状态。

使用方式

技能目录布局为:

<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。

核心原则包括:从上次更新以来与决策相关的增量开始;区分事实、解读、风险和请求;不要埋没请求,明确导师需要提供的输入;将原始实验细节压缩为证据和影响,必要时链接到详细报告;当负结果会改变项目决策时,应包含负结果;在会议或回复后把反馈转化为行动和记忆更新;匹配受众:导师更新直接且偏决策,实验室更新需要更多背景,合作者说明需要明确归属和交接。

适用场景

适用于需要向导师、指导者、合作者或实验室同步研究进展并寻求决策、反馈、资源、算力、论文定位建议或优先级选择的场合。可配合以下技能使用:research-project-memory 用于恢复当前状态、决策、主张、证据、风险和行动;experiment-report-writer 当需要详细实验证据源报告时;figure-results-review 当要向导师展示图表或表格时;result-diagnosis 当负结果或模糊结果需要决策时;paper-positioning-planner 当更新询问论文故事或目标会议反馈时;paper-evidence-board 当写作和实验缺口需要同步行动清单时;work-timeline-planner 当更新需要回顾性时间线证据时。

限制

该技能不用于完整实验报告。若主要产出是详细技术报告,应改用 experiment-report-writer。官方文本未提供关于收费、价格、平台兼容性、具体效果或更多使用步骤的信息,暂未提供。