360 Secure SkillHub
360 安全技能中心

Apollo Writing Plans

该 Skill 在写代码前先理解任务与技术栈,把大任务拆成带文件路径、测试代码和预期输出的2-5分钟小步骤,保存为 Markdown 计划文档,并在完成后询问采用子 Agent 还是独立会话执行。

nic-yuan
nic-yuan
热度 22.20
最近更新 2026-04-05 04:16:52
分类:开发依赖:读写文件 / 代码执行应用场景:代码生成 / 任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add apollo-writing-plans
Metadata
name
apollo-writing-plans
description
把大任务拆成小步骤,每步几分钟,写成清晰计划再动手。适合在动手写代码前先做规划。
version
1.0.0

Apollo 写作计划

触发场景

当用户提到"写计划"、"任务分解"、"实现步骤"、"先做计划"、"执行计划"时激活。

核心原则

  1. 先计划,后行动:在写代码前先写完整计划
  2. 小步执行:每步控制在2-5分钟
  3. 可验证:每个步骤有明确的验证方式

工作流程

Step 1:理解任务

明确:

  • 用户想要实现什么?
  • 技术栈是什么?
  • 有什么限制条件?

Step 2:任务分解

将任务分解为独立步骤,每步:

  • 一个具体操作(2-5分钟)
  • 有明确的输入输出
  • 有验证方式

Step 3:生成计划文档

保存到:docs/plans/YYYY-MM-DD-<功能名>.md

格式:

# [功能名称] 实现计划

目标:[一句话描述要实现什么]

## 技术方案
[2-3句话描述技术路径]

## 步骤

### 步骤1:[具体操作]
**文件:**
- 创建:`src/path/file.py`

**Step 1:写失败的测试**
[测试代码]

**Step 2:验证测试失败**
运行:`pytest tests/path/test.py -v`
预期:FAIL

**Step 3:写实现代码**
[实现代码]

**Step 4:验证测试通过**
运行:`pytest tests/path/test.py -v`
预期:PASS

### 步骤2:[...]

执行选择

计划完成后询问用户:

"计划已保存。两种执行方式:

1. 子Agent驱动(当前会话)

  • 每个步骤派一个新的子Agent执行
  • 每步完成后人工审核
  • 快速迭代

2. 独立会话执行

  • 在工作目录开新会话
  • 批量执行所有步骤
  • 有检查点存档

选哪种?"

注意事项

  • 精确的文件路径
  • 完整的代码(不是"添加验证")
  • 带预期输出的验证命令
  • 小步快跑,每步都验证