制定写作计划
概述
编写详尽的撰写实施计划,假设执行该计划的研究助理对我们的文献库毫无背景知识,且学术品味存疑。记录他们需要知道的一切:每个任务涉及哪些章节文件、核心论点、需要查阅的证据、如何验证逻辑。将整个计划分解为一口大小的任务。避免重复 (DRY)。不需要的不写 (YAGNI)。论证驱动写作 (ADW)。频繁提交。
假设他们是一位熟练的写作者,但几乎不了解我们的工具集或研究领域。假设他们不太懂得良好的论证逻辑设计。
开始时声明: “我正在使用 planning 技能来创建撰写实施计划。”
上下文: 这应该在一个专门的工作树(由 ideation 技能创建)中运行。
保存计划至: docs/plans/YYYY-MM-DD-<feature-name>.md
任务粒度
每个步骤是一个动作(2-5分钟):
- •“写出缺失证据的主张(失败的测试)” - 步骤
- •“阅读它以确保它缺乏支持” - 步骤
- •“撰写最简内容以提供证据支持” - 步骤
- •“检查逻辑并确保论证成立” - 步骤
- •“提交” - 步骤
计划文档标头
每个计划必须以从以下标头开始:
markdown
# [章节/论题名称] 撰写实施计划 > **For Claude:** REQUIRED SUB-SKILL: Use superpowers:sa-execution to implement this plan task-by-task. **目标:** [一句话描述本部分旨在论证什么] **逻辑架构:** [2-3 句话描述论证方法] **理论框架/工具:** [关键理论/引用来源] ---
任务结构
markdown
### 任务 N: [小节名称] **文件:** - 创建:`exact/path/to/section.tex` (或 .md) - 修改:`exact/path/to/existing.tex:123-145` - 验证:`tests/exact/path/to/validation_checklist.md` **步骤 1: 提出待验证的主张 (Write the failing test)** ```markdown <!-- 预期论点 --> 主张:X 变量对 Y 变量有显著正向影响。 现状:文中尚无此主张的实证支持。
步骤 2: 验证主张缺乏支持 (Run test to verify it fails)
检查:阅读当前草稿 预期:未找到支持该主张的段落或数据引用。
步骤 3: 撰写最简内容 (Write minimal implementation)
markdown
根据 Z 研究 (2023),X 的增加通常伴随着 Y 的改善...
步骤 4: 验证论证成立 (Run test to verify it passes)
检查:阅读新撰写的段落 预期:主张现在有明确的证据支持,且逻辑连贯。
步骤 5: 提交 (Commit)
bash
git add tests/path/validation.md src/path/section.tex git commit -m "feat: add specific argument about X and Y"
code
## 记住 - 始终使用确切的文件路径 - 计划中包含完整的文本草稿(不仅仅是“添加论证”) - 包含确切的验证指令和预期结果 - 使用 @ 语法引用相关技能 - DRY (不要重复), YAGNI (你不需要它), ADW (论证驱动写作), 频繁提交 ## 执行移交 保存计划后,提供执行选项: **“计划已完成并保存至 `docs/plans/<filename>.md`。两个执行选项:** **1. 子智能体驱动 (本会话)** - 我为每个任务分派一个新的子智能体,并在任务之间进行审阅,快速迭代 **2. 并行会话 (独立)** - 使用 execution 打开新会话,带检查点的批量执行 **选择哪种方法?”** **如果选择子智能体驱动:** - **REQUIRED SUB-SKILL:** Use superpowers:sa-drafting - 留在这个会话中 - 每个任务使用新的子智能体 + 同行评审 **如果选择并行会话:** - 引导他们在工作树中打开新会话 - **REQUIRED SUB-SKILL:** 新会话使用 superpowers:sa-execution