writing-plans

假設工程師對我們的程式碼庫的背景為零且品味有問題,則編寫全面的實施計劃。記錄他們需要知道的一切:每個任務要接觸哪些文件、程式碼、測試、他們可能需要檢查的文檔、如何測試它。將整個計劃作為小任務交給他們。乾燥。亞格尼。時分驅動。頻繁提交。

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "writing-plans" with this command: npx skills add zhucl1006/ailesuperpowers/zhucl1006-ailesuperpowers-writing-plans

寫作計劃

概述

假設工程師對我們的程式碼庫的背景為零且品味有問題,則編寫全面的實施計劃。記錄他們需要知道的一切:每個任務要接觸哪些文件、程式碼、測試、他們可能需要檢查的文檔、如何測試它。將整個計劃作為小任務交給他們。乾燥。亞格尼。時分驅動。頻繁提交。

假設他們是一位熟練的開發人員,但對我們的工具集或問題領域幾乎一無所知。假設他們不太瞭解良好的測試設計。

開始時宣佈:“我正在使用寫作計劃技能來創建實施計劃。”

上下文: 這應該在專用工作樹中運作(透過腦力激盪技能創建)。

將計劃保存到: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/&#x3C;filename>.md`。兩種執行選項:**

**1.子代理驅動(本次會議)** - 我為每個任務分配新的子代理,在任務之間進行審查,快速迭代

**2.並行會話(單獨)** - 使用執行計劃打開新會話,使用檢查點批量執行

**哪一種方法? ”**

**如果選擇子代理驅動:**
- **所需的子技能:** 使用超能力:子代理驅動開發
- 留在本次會議
- 每個任務新鮮的子代理+程式碼審查

**如果選擇並行會議:**
- 引導他們在工作樹中打開新會話
- **所需的子技能:** 新會話使用超能力:執行計劃

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

aile-pencil-design

No summary provided by upstream source.

Repository SourceNeeds Review
General

aile-delivery-report

No summary provided by upstream source.

Repository SourceNeeds Review
General

aile-writing-plans

No summary provided by upstream source.

Repository SourceNeeds Review
General

aile-docs-init

No summary provided by upstream source.

Repository SourceNeeds Review