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

plan-writing by claudiodearaujo/izacenter

1 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/claudiodearaujo/izacenter --skill plan-writing

方法论开发项目管理

🇨🇳中文介绍

计划编写

来源：obra/superpowers

概述

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

任务分解原则

1. 小而专注的任务

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

2. 清晰的验证

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

3. 逻辑排序

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

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

计划文件以 {task-slug}.md 的形式保存在项目根目录
名称源自任务（例如，"add auth" → 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：基于项目类型的动态内容

对于新项目：

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

对于功能添加：

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

对于错误修复：

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

原则 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: [具体操作] → 验证: [如何检查]

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

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

[任何重要的注意事项]

最佳实践（快速参考）

从目标开始 - 我们要构建/修复什么？
最多 10 个任务 - 如果更多，请拆分成多个计划
每个任务都可验证 - 清晰的"完成"标准
项目特定 - 不要复制粘贴模板
边做边更新 - 完成时标记 [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

claudiodearaujo…zacenter

GitHub Stars

First Seen

Today

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

zencoder1

amp1

cline1

openclaw1

opencode1

cursor1

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

109,600 周安装