SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 11-13 20:56

技能介绍

Writing Plans 是一个技能,用于在设计完成后创建详细的实施计划,假设执行计划的工程师对代码库几乎零背景,且测试设计能力有限。

用途:该技能帮助将设计转化为可执行的任务列表,每个任务包含精确的文件路径、完整代码示例、测试步骤和提交命令,确保工程师能够按步骤独立完成实现。

主要能力:

  • 外部文档搜索:在规划前,可通过 Context7 MCP 搜索相关库的最新 API 文档,支持用户指定或自动检测库名。
  • Python 项目检测:自动识别 Python 项目及框架(如 FastAPI、Django),并加载对应的 python 插件技能(如 python:python-testing、python:python-project、python:python-performance)以复用测试和项目模式。
  • 任务粒度控制:每个步骤为 2-5 分钟的操作,如编写失败测试、运行测试确认失败、实现最小代码、运行测试确认通过、提交。
  • 复杂度分类:每个任务标记为 TRIVIAL、SIMPLE、MODERATE 或 COMPLEX,并对应不同的 TDD 和代码审查要求。
  • 计划文档结构:包含目标、架构、技术栈、任务列表(含文件路径、代码块、命令和预期输出)。
  • 图表生成:可选生成 Mermaid 图表(如任务依赖、架构、序列、状态、数据模型),帮助执行时理解复杂计划。
  • 执行交接:计划保存后,可选择子代理驱动执行、并行会话执行或跳过。

使用方式:触发技能后,首先宣布使用该技能,然后按步骤进行外部文档搜索(若 Context7 可用)、Python 项目检测、任务分解、代码示例编写、图表生成(可选),最后保存计划到 docs/plans/YYYY-MM-DD-<feature-name>.md 并询问执行方式。

适用场景:适用于需要详细实施计划的软件开发任务,尤其是设计已完成、需要指导缺乏代码库背景的工程师执行的情况。

限制:该技能依赖 Claude 的特定工具(如 AskUserQuestion、Skill 工具、Task 工具)和插件生态(如 python 插件、doc:diagram-generator)。若 Context7 不可用,则跳过文档搜索。图表生成在任务少于 3 个或纯线性、单文件变更、仅配置变更时可跳过。