计划撰写技能：AI辅助任务分解与项目管理框架，提升开发效率

plan-writing by vudovn/antigravity-kit

91 周安装量

6,900 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vudovn/antigravity-kit --skill plan-writing

开发项目管理生产力

🇨🇳中文介绍

计划撰写

来源：obra/superpowers

概述

此技能提供了一个框架，用于将工作分解为清晰、可执行且带有验证标准的任务。

任务分解原则

1. 小型、专注的任务

每个任务应耗时 2-5 分钟
每个任务一个明确的结果
可独立验证

2. 清晰的验证

如何知道任务已完成？
可以检查/测试什么？
预期的输出是什么？

3. 逻辑排序

识别依赖关系
尽可能并行工作
突出关键路径
阶段 X：验证始终是最后一步

4. 项目根目录下的动态命名

计划文件以 {task-slug}.md 格式保存在项目根目录下
名称源自任务（例如，“添加认证” → auth-feature.md）
绝不保存在 .claude/、docs/ 或临时文件夹内

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

规划原则（非模板！）

🔴 没有固定模板。每个计划都针对任务量身定制。

原则 1：保持简短

❌ 错误做法	✅ 正确做法
50 个带有子子任务的任务	最多 5-10 个清晰的任务
列出每个微步骤	仅列出可执行项
冗长的描述	每个任务一行

规则： 如果计划超过 1 页，那就太长了。请简化。

原则 2：具体而非笼统

❌ 错误做法	✅ 正确做法
“设置项目”	“运行 `npx create-next-app`”
“添加认证”	“安装 next-auth，创建 `/api/auth/[...nextauth].ts`”
“设计 UI 样式”	“向 `Header.tsx` 添加 Tailwind 类”

规则： 每个任务都应有一个清晰、可验证的结果。

原则 3：基于项目类型的动态内容

对于新项目：

使用什么技术栈？（首先决定）
MVP（最小可行产品）是什么？（最小功能集）
文件结构是怎样的？

对于功能添加：

哪些文件会受影响？
需要哪些依赖项？
如何验证其正常工作？

对于错误修复：

根本原因是什么？
需要更改哪个文件/哪一行？
如何测试修复？

原则 4：脚本是项目特定的

🔴 不要复制粘贴脚本命令。根据项目类型选择。

项目类型	相关脚本
前端/React	`ux_audit.py`, `accessibility_checker.py`
后端/API	`api_validator.py`, `security_scan.py`
移动端	`mobile_audit.py`
数据库	`schema_validator.py`
全栈	根据你修改的内容混合使用上述脚本

错误做法： 将所有脚本添加到每个计划中 正确做法： 仅添加与此任务相关的脚本

原则 5：验证要简单

❌ 错误做法	✅ 正确做法
“验证组件正常工作”	“运行 `npm run dev`，点击按钮，看到提示”
“测试 API”	“curl localhost:3000/api/users 返回 200”
“检查样式”	“打开浏览器，验证深色模式切换功能正常”

计划结构（灵活，非固定！）

# [任务名称]

## 目标
一句话：我们要构建/修复什么？

## 任务
- [ ] 任务 1: [具体操作] → 验证: [如何检查]
- [ ] 任务 2: [具体操作] → 验证: [如何检查]
- [ ] 任务 3: [具体操作] → 验证: [如何检查]

## 完成标准
- [ ] [主要成功标准]

就这样。 除非确实需要，否则不要分阶段、不要分小节。保持极简。仅在需要时增加复杂性。

[任何重要的注意事项]

---

## 最佳实践（快速参考）

1. **从目标开始** - 我们要构建/修复什么？
2. **最多 10 个任务** - 如果更多，请拆分成多个计划
3. **每个任务都可验证** - 清晰的“完成”标准
4. **项目特定** - 不要复制粘贴模板
5. **边做边更新** - 完成时标记 `[x]`

---

## 使用场景

- 从零开始的新项目
- 添加功能
- 修复错误（如果复杂）
- 重构多个文件

🇺🇸English

Plan Writing

Source: obra/superpowers

Overview

This skill provides a framework for breaking down work into clear, actionable tasks with verification criteria.

Task Breakdown Principles

1. Small, Focused Tasks

Each task should take 2-5 minutes
One clear outcome per task
Independently verifiable

2. Clear Verification

How do you know it's done?
What can you check/test?
What's the expected output?

3. Logical Ordering

Dependencies identified
Parallel work where possible
Critical path highlighted
Phase X: Verification is always LAST

4. Dynamic Naming in Project Root

Plan files are saved as {task-slug}.md in the PROJECT ROOT
Name derived from task (e.g., "add auth" → auth-feature.md)
NEVER inside .claude/, docs/, or temp folders

Planning Principles (NOT Templates!)

🔴 NO fixed templates. Each plan is UNIQUE to the task.

Principle 1: Keep It SHORT

❌ Wrong	✅ Right
50 tasks with sub-sub-tasks	5-10 clear tasks max
Every micro-step listed	Only actionable items
Verbose descriptions	One-line per task

Rule: If plan is longer than 1 page, it's too long. Simplify.

Principle 2: Be SPECIFIC, Not Generic

❌ Wrong	✅ Right
"Set up project"	"Run `npx create-next-app`"
"Add authentication"	"Install next-auth, create `/api/auth/[...nextauth].ts`"
"Style the UI"	"Add Tailwind classes to `Header.tsx`"

Rule: Each task should have a clear, verifiable outcome.

Principle 3: Dynamic Content Based on Project Type

For NEW PROJECT:

What tech stack? (decide first)
What's the MVP? (minimal features)
What's the file structure?

For FEATURE ADDITION:

Which files are affected?
What dependencies needed?
How to verify it works?

For BUG FIX:

What's the root cause?
What file/line to change?
How to test the fix?

Principle 4: Scripts Are Project-Specific

🔴 DO NOT copy-paste script commands. Choose based on project type.

Project Type	Relevant Scripts
Frontend/React	`ux_audit.py`, `accessibility_checker.py`
Backend/API	`api_validator.py`, `security_scan.py`
Mobile	`mobile_audit.py`
Database	`schema_validator.py`
Full-stack	Mix of above based on what you touched

Wrong: Adding all scripts to every plan Right: Only scripts relevant to THIS task

Principle 5: Verification is Simple

❌ Wrong	✅ Right
"Verify the component works correctly"	"Run `npm run dev`, click button, see toast"
"Test the API"	"curl localhost:3000/api/users returns 200"
"Check styles"	"Open browser, verify dark mode toggle works"

Plan Structure (Flexible, Not Fixed!)

# [Task Name]

## Goal
One sentence: What are we building/fixing?

## Tasks
- [ ] Task 1: [Specific action] → Verify: [How to check]
- [ ] Task 2: [Specific action] → Verify: [How to check]
- [ ] Task 3: [Specific action] → Verify: [How to check]

## Done When
- [ ] [Main success criteria]

That's it. No phases, no sub-sections unless truly needed. Keep it minimal. Add complexity only when required.

Notes

[Any important considerations]

---

## Best Practices (Quick Reference)

1. **Start with goal** - What are we building/fixing?
2. **Max 10 tasks** - If more, break into multiple plans
3. **Each task verifiable** - Clear "done" criteria
4. **Project-specific** - No copy-paste templates
5. **Update as you go** - Mark `[x]` when complete

---

## When to Use

- New project from scratch
- Adding a feature
- Fixing a bug (if complex)
- Refactoring multiple files

Weekly Installs

Repository

vudovn/antigravity-kit

GitHub Stars

6.6K

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli68

codex67

opencode62

cursor57

antigravity55

github-copilot55

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

120,000 周安装