安装命令
npx skills add https://github.com/aleister1102/skills --skill writing-plans🇨🇳中文介绍
编写计划
概述
编写全面的实施计划，假设工程师对我们的代码库零了解且品味存疑。记录他们需要知道的一切：每个任务需要修改哪些文件、代码、可能需要查阅的测试和文档、如何进行测试。将整个计划分解为易于处理的小任务。遵循 DRY、YAGNI、TDD 原则。频繁提交。
假设他们是一名熟练的开发人员，但几乎不了解我们的工具集或问题领域。假设他们不太了解良好的测试设计。
开始时声明： "我正在使用 writing-plans 技能来创建实施计划。"
上下文： 这应该在专用工作树中运行（由 brainstorming 技能创建）。
计划保存到： docs/plans/YYYY-MM-DD-<feature-name>.md
易于处理的任务粒度
每个步骤是一个动作（2-5 分钟）：
- "编写失败的测试" - 步骤
- "运行测试以确保它失败" - 步骤
- "实现使测试通过的最简代码" - 步骤
- "运行测试并确保它们通过" - 步骤
- "提交" - 步骤
计划文档头部
每个计划必须以这个头部开始：
# [功能名称] 实施计划
> **给 Claude 的提示：** 必需子技能：使用 superpowers:executing-plans 来按任务实施此计划。
**目标：** [一句话描述构建的内容]
**架构：** [2-3 句关于方法的描述]
**技术栈：** [关键技术/库]
---
任务结构
### 任务 N: [组件名称]
**文件：**
- 创建：`exact/path/to/file.py`
- 修改：`exact/path/to/existing.py:123-145`
- 测试：`tests/exact/path/to/test.py`
**步骤 1：编写失败的测试**
```python
def test_specific_behavior():
result = function(input)
assert result == expected
**步骤 2：运行测试以验证失败**
运行：`pytest tests/path/test.py::test_name -v` 预期：失败，提示"函数未定义"
**步骤 3：编写最简实现**
def function(input):
return expected
**步骤 4：运行测试以验证通过**
运行：`pytest tests/path/test.py::test_name -v` 预期：通过
**步骤 5：提交**
git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"
## 记住
- 始终使用确切的文件路径
- 计划中包含完整的代码（而不是"添加验证"）
- 确切的命令和预期输出
- 使用 @ 语法引用相关技能
- DRY, YAGNI, TDD, 频繁提交
## 执行交接
保存计划后，提供执行选择：
**"计划已完成并保存到 `docs/plans/<filename>.md`。两种执行选项：**
**1. 子代理驱动（本次会话）** - 我为每个任务派遣新的子代理，在任务间进行审查，快速迭代
**2. 并行会话（独立）** - 使用 executing-plans 打开新会话，通过检查点进行批量执行
**选择哪种方式？"**
**如果选择子代理驱动：**
- **必需子技能：** 使用 superpowers:subagent-driven-development
- 保持在此会话中
- 每个任务使用新的子代理 + 代码审查
**如果选择并行会话：**
- 指导他们在工作树中打开新会话
- **必需子技能：** 新会话使用 superpowers:executing-plans
🇺🇸English
Writing Plans
Overview
Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.
Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well.
Announce at start: "I'm using the writing-plans skill to create the implementation plan."
Context: This should be run in a dedicated worktree (created by brainstorming skill).
Save plans to: docs/plans/YYYY-MM-DD-<feature-name>.md
Bite-Sized Task Granularity
Each step is one action (2-5 minutes):
- "Write the failing test" - step
- "Run it to make sure it fails" - step
- "Implement the minimal code to make the test pass" - step
- "Run the tests and make sure they pass" - step
- "Commit" - step
Plan Document Header
Every plan MUST start with this header:
# [Feature Name] Implementation Plan
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
**Goal:** [One sentence describing what this builds]
**Architecture:** [2-3 sentences about approach]
**Tech Stack:** [Key technologies/libraries]
---
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
