AgentSkillsCN

sa-planning

当你面对多步骤的写作任务,且已有明确的规范或要求时,在正式动笔之前,不妨先借助此技能理清思路、厘清脉络。

SKILL.md
--- frontmatter
name: sa-planning
description: 当你拥有多步骤写作任务的规范或要求时使用,在开始撰写正文之前

制定写作计划

概述

编写详尽的撰写实施计划,假设执行该计划的研究助理对我们的文献库毫无背景知识,且学术品味存疑。记录他们需要知道的一切:每个任务涉及哪些章节文件、核心论点、需要查阅的证据、如何验证逻辑。将整个计划分解为一口大小的任务。避免重复 (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