SuperAPI AI 工具集

planning-foundation

写作与研究

查看项目

更新于 10-16 06:14

技能介绍

用途:为复杂写作任务提供磁盘上的持久工作记忆。将重要内容写入 .writing/,使论文状态在上下文重置或新会话后仍可恢复。目录包含 metadata.yaml、outline.md、ideation.md、claims/、manuscript/、figures/、refs.bib、findings.md、progress.md、agents/、archive/ 等。outline.md 即论文的设计规范,没有单独的设计文档。

主要能力:通过文件区分内容类型,outline.md 保存 IMRAD 结构与各节主张;claims/ 保存主张存根(CLAIM / EVIDENCE / STATUS);findings.md 记录发现、决策、被否决方案与约束;progress.md 保存任务状态面板、阶段状态、写入文件与错误。

使用方式:开始前创建 .writing/,运行 bash "${CLAUDE_PLUGIN_ROOT}/scripts/init-writing-dir.sh",或手动创建并写入两个种子文件。遵守 2-action 规则:每约两次读取/搜索/探索操作后按内容类型写入相应文件。重大决策前重读 outline。每次出错都记录到 progress.md,反复失败则上报用户,不要自行绕过。子代理各自获得 .writing/agents/{role}/,含独立 findings.md 与 progress.md,编排者用 aggregate-agent-findings.sh 汇总到顶层文件。

适用场景:多步骤写作、研究线索、跨多次工具调用或会话的任务。简单问题、单文件编辑和快速查询可跳过。可用 5 问重启测试检查状态管理:我在哪(任务面板)、要去哪(剩余阶段)、目标是什么(outline)、学到了什么(findings.md)、做过了什么(progress.md)。

限制:不适用于简单查询;Task API 仅限当前会话,不能作为跨会话记忆;不要隐藏错误或静默重试;不要把所有内容塞进上下文。脚本在插件根目录以 bash "${CLAUDE_PLUGIN_ROOT}/scripts/<name>" 调用,包括 init-writing-dir.sh、check-writing-state.sh、writing-reset.sh、snapshot-save.sh、aggregate-agent-findings.sh 及若干检测辅助脚本。具体收费、平台支持与安装方式暂未提供。