writing-plans

Generate executable implementation roadmaps for multi-step software features.

7.6k|721|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/jnMetaCode/superpowers-zh --skill writing-plans-jnmetacode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/writing-plans
Command: npx skills add https://github.com/jnMetaCode/superpowers-zh --skill writing-plans-jnmetacode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

规划多步软件特性时,帮助团队在动手编码前生成全面且可执行的实现计划,记录需要修改的文件、代码、测试、所需文档以及测试方法;将大任务拆分成小步骤,遵循 DRY、YAGNI、TDD,并频繁提交。

Core Features & Use Cases

  • 支持跨文件变更的任务分解,逐步列出需要创建或修改的文件、测试和文档
  • 提供清晰的使用场景示例,帮助团队对齐实现思路
  • 具备计划头部模板、任务结构和自检步骤,便于交接与审查

Quick Start

在开始实现前,使用 writing-plans 技能创建一个包含将要修改的文件、测试和验证步骤的详细计划。

Frequently Asked Questions about writing-plans

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down multi-step software features into an executable implementation plan?

To break down multi-step software features, you create an executable implementation plan that specifies file changes, tests, documentation, and validation steps, structuring large tasks into a clear step-by-step roadmap.

What is the best way to plan file changes and test validation before coding?

The best way to plan file changes is by generating a detailed roadmap that lists required file modifications, testing methods, and documentation needs, ensuring all tasks are clear and testable before coding begins.

How do I create a task breakdown template that enforces TDD and DRY principles?

You create a task breakdown template that enforces TDD and DRY by structuring your roadmap with dedicated sections for tests, validation, and step-by-step implementation, storing the results as Markdown files.

Does this planning workflow support storing implementation roadmaps as Markdown documentation?

Yes, this planning workflow supports storing implementation roadmaps as Markdown documentation by saving the generated plans directly under the docs/superpowers/plans directory for team alignment and review.

Can I use this task planning method for cross-file changes and frequent commits?

Yes, you can use this task planning method for cross-file changes, as it breaks down large tasks into small steps that list required file modifications and tests, supporting frequent commits and structured validation.

When do I need a structured implementation roadmap for software development?

You need a structured implementation roadmap when planning multi-step software features, ensuring your team aligns on file changes, tests, and validation steps before starting the actual coding process.