寫作計劃
概述
假設工程師對我們的程式碼庫的背景為零且品味有問題,則編寫全面的實施計劃。記錄他們需要知道的一切:每個任務要接觸哪些文件、程式碼、測試、他們可能需要檢查的文檔、如何測試它。將整個計劃作為小任務交給他們。乾燥。亞格尼。時分驅動。頻繁提交。
假設他們是一位熟練的開發人員,但對我們的工具集或問題領域幾乎一無所知。假設他們不太瞭解良好的測試設計。
開始時宣佈:“我正在使用寫作計劃技能來創建實施計劃。”
上下文: 這應該在專用工作樹中運作(透過腦力激盪技能創建)。
將計劃保存到:docs/plans/YYYY-MM-DD-<feature-name>.md
一口大小的任務粒度
每一步都是一個動作(2-5 分鐘):
-
“編寫失敗的測試”-步驟
-
「運行它以確保它失敗」-步驟
-
“實現最少的程式碼以使測試通過” - 步驟
-
“運行測試並確保它們通過”- 步驟
-
“提交”-步驟
計劃文檔標題
每個計劃必須以此標題開頭:
[Feature Name] Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: [One sentence describing what this builds]
Architecture: [2-3 sentences about approach]
Tech Stack: [Key technologies/libraries]
任務結構
Task N: [Component Name]
Files:
- Create:
exact/path/to/file.py - Modify:
exact/path/to/existing.py:123-145 - Test:
tests/exact/path/to/test.py
Step 1: Write the failing test
def test_specific_behavior():
結果 = 函數(輸入)
斷言結果==預期
Step 2: Run test to verify it fails
Run: pytest tests/path/test.py::test_name -v
Expected: FAIL with "function not defined"
Step 3: Write minimal implementation
def函數(輸入):
預期回報
Step 4: Run test to verify it passes
Run: pytest tests/path/test.py::test_name -v
Expected: PASS
Step 5: Commit
git add tests/path/test.py src/path/file.py
git commit -m“壯舉:新增特定功能”
## 記住
- 始終精確的文件路徑
- 計劃中的完整代碼(不是“添加驗證”)
- 具有預期輸出的精確命令
- 用@語法參考相關技巧
- DRY、YAGNI、TDD、間隙空間
## 執行交接
保存計劃後,提供執行選擇:
**“計劃完成並保存到`docs/plans/<filename>.md`。兩種執行選項:**
**1.子代理驅動(本次會議)** - 我為每個任務分配新的子代理,在任務之間進行審查,快速迭代
**2.並行會話(單獨)** - 使用執行計劃打開新會話,使用檢查點批量執行
**哪一種方法? ”**
**如果選擇子代理驅動:**
- **所需的子技能:** 使用超能力:子代理驅動開發
- 留在本次會議
- 每個任務新鮮的子代理+程式碼審查
**如果選擇並行會議:**
- 引導他們在工作樹中打開新會話
- **所需的子技能:** 新會話使用超能力:執行計劃