技能 writing-plans
📋

writing-plans

安全

为多步骤编码任务生成详细的实现计划

也可从以下获取: Cycleaddict,obra,ZhanlinCui,DYAI2025,davila7,DMJGilbert,Cygnusfear,CodingCossack

将规范转化为可操作的实施计划,包含细粒度任务。这项技能通过在假设零先验上下文的情况下创建全面的文档,弥合需求与代码之间的差距。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“writing-plans”。 创建添加密码重置功能的计划

预期结果:

  • # 密码重置实施计划
  •  
  • **目标:** 允许用户通过电子邮件链接重置密码
  •  
  • **架构:** 基于令牌的重置流程,带过期时间,使用现有邮件服务
  •  
  • **技术栈:** Node.js, PostgreSQL, Nodemailer
  •  
  • ---
  •  
  • ### 任务 1:数据库模式
  •  
  • **文件:**
  • - 修改:`migrations/001_add_password_reset.sql`
  •  
  • **步骤 1:创建迁移文件**
  •  
  • ```sql
  • ALTER TABLE users ADD COLUMN password_reset_token TEXT;
  • ALTER TABLE users ADD COLUMN password_reset_expires TIMESTAMP;
  • ```
  •  
  • **步骤 2:运行迁移**
  •  
  • 运行:`npm run migrate`
  • 预期:'Migration successful'

正在使用“writing-plans”。 规划 REST API 端点的实现

预期结果:

  • ### 任务 3:创建 API 端点
  •  
  • **文件:**
  • - 创建:`src/api/users.ts`
  • - 测试:`tests/api/users.test.ts`
  •  
  • **步骤 1:编写失败的测试**
  •  
  • ```typescript
  • describe('GET /api/users/:id', () => {
  • it('returns user by id', async () => {
  • const response = await request(app).get('/api/users/1');
  • expect(response.status).toBe(200);
  • expect(response.body.name).toBe('Test User');
  • });
  • });
  • ```
  •  
  • **步骤 2:运行测试验证失败**
  •  
  • 运行:`npm test -- tests/api/users.test.ts`
  • 预期:FAIL with 'Cannot GET /api/users/1'

安全审计

安全
v1 • 2/25/2026

Static analysis detected 20 potential issues (16 external command patterns, 4 weak cryptography flags). All are false positives from markdown code spans and code blocks in documentation. This is a documentation-only skill with no executable code, network operations, or security risks. Safe to publish.

1
已扫描文件
122
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
100
规范符合性

你能构建什么

新开发人员入职

创建详细的计划,帮助不熟悉代码库的开发人员正确实现功能,而无需持续监督

复杂功能实现

将多步骤功能分解为可管理的任务,包含清晰的测试和验证步骤,实现系统化开发

测试驱动开发工作流

生成 TDD 任务序列,指导开发人员先编写测试,然后实现代码,最后验证功能

试试这些提示

基本实施计划
Create an implementation plan for adding user authentication to our web application. Use the writing-plans skill to break this down into bite-sized tasks.
重构计划
Use writing-plans to create a detailed plan for refactoring the payment processing module. Include tests, file changes, and migration steps.
API 集成计划
I need to integrate the Stripe API for subscription management. Use writing-plans to create a complete implementation plan with all necessary steps.
多组件功能
Create an implementation plan for our real-time notification system that includes database changes, API endpoints, background workers, and frontend components.

最佳实践

  • 始终从包含目标、架构和技术栈的必需计划头开始,以提供完整的上下文
  • 将任务分解为最小的单元(每个 2-5 分钟),使开发人员能够通过频繁的提交取得稳定进展
  • 在计划中包含精确的文件路径和完整的代码示例,以消除实施过程中的歧义和决策
  • 在每一步指定预期的测试输出,以便开发人员在继续之前验证他们的工作

避免

  • 编写模糊的指令,如'添加验证'或'更新处理程序',而没有指定确切的代码和文件位置
  • 创建合并多个步骤的大型任务,这使得进度跟踪和错误隔离变得困难
  • 跳过测试用例或预期输出,这迫使开发人员猜测成功是什么样子的
  • 省略计划头或上下文部分,假设实施者具有背景知识

常见问题

我应该何时使用此技能?
当你有多步骤功能的规范或需求文档,并需要在编写任何代码之前创建详细的实施计划时,使用此技能。
什么使任务成为细粒度任务?
细粒度任务需要 2-5 分钟完成,代表单个操作,如编写一个测试、运行它、实现最小代码或提交。
我需要遵循 TDD 吗?
此技能鼓励 TDD 实践(编写测试、验证失败、实现、验证成功、提交),但你可以根据你的工作流调整任务结构。
计划创建后会发生什么?
保存计划后,你可以在同一会话或并行会话中选择使用 executing-plans 技能进行批处理执行。
计划保存在哪里?
计划保存到 `docs/plans/YYYY-MM-DD-<feature-name>.md`,使用标准化的文件名格式以便于引用。
创建后我可以修改计划吗?
是的,计划是活的 Markdown 文档。如果需求变更或实施揭示遗漏的步骤,请更新它们。

开发者详情

文件结构

📄 SKILL.md