SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-16 04:19

技能介绍

用途

writing-plans 用于在设计阶段已完成、需要为对代码库熟悉度极低的工程师编写详细实现任务的场景。它生成一份综合性的实现指南,其中包含精确的文件路径、代码示例和验证步骤。

主要能力

任务粒度

每个步骤代表约 2-5 分钟的工作量,将功能拆解为原子动作,例如:编写失败测试、实现解决方案、提交变更。

文档标准

计划遵循强制性的头部格式,包含目标、架构与技术栈,随后是带文件位置、代码片段和精确命令序列的编号任务。

计划结构

# Feature Name

## Goal
[One sentence: what this accomplishes]

Architecture

[How this fits in the system]

Tech Stack

[Libraries/frameworks used]

Tasks

1. [Task name]

File: path/to/file.ts

[What to do]

Code:

[Exact code or snippet]

Verify:

[Commands to run]

Commit: [commit message]

2. [Next task...]

核心原则

  • DRY - Don't Repeat Yourself
  • YAGNI - You Aren't Gonna Need It
  • TDD - Test-Driven Development
  • 频繁提交 - 一个任务,一次提交

使用方式

执行工作流

计划完成后,提供两种实现路径:

  1. 子智能体驱动 — 在当前会话中为每个任务分派全新的智能体并进行评审
  2. 并行会话 — 使用 executing-plans 技能引导至独立的会话

计划应包含的内容

  • 精确的文件路径(不使用模糊位置)
  • 完整的代码片段(不是伪代码)
  • 验证命令
  • 预期输出
  • 每个步骤的提交信息
  • 任务之间的依赖关系
  • 需要处理的边界情况

输出位置

保存至:docs/plans/YYYY-MM-DD-<feature-name>.md

适用场景

  • 设计阶段已完成
  • 需要逐步实现指南
  • 与不熟悉代码库的工程师协作
  • 拆解复杂功能
  • 确保实现方式的一致性

限制

关于本技能的收费、价格、平台支持或具体效果等事实,资料中暂未提供。