Skip to content

OthmanAdi/planning-with-files / skills/i18n/planning-with-files-zht

planning-with-files-zht

Verified

用於多步驟 AI 代理工作的持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上,生命週期鉤子會注入選定的專案規劃內容。自動恢復只讀取專案規劃檔案;只有明確執行 session-catchup.py --metadata 才會檢查本機同一專案的代理工作階段中繼資料,--replay 則會輸出有界且以 nonce 框定的摘錄。選用的閘門模式只會在主機支援時要求繼續,而且絕不執行 Markdown 中宣告的命令。此技能沒有網路上傳路徑。適用於研究或需要超過 5 次工具呼叫的工作。觸發詞:任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案

templates/task_plan.md

View on GitHub
# 任務計畫:[簡要描述]

將此檔案作為任務的持久化路線圖。開始複雜工作前先建立它,並在階段變更時持續更新。

## 目標

用一句清楚的話描述預期的最終結果。

[用一句話描述最終狀態]

## 下一步

記錄接下來唯一要執行的動作。每當目前階段或立即行動變更時都要更新。

[接下來唯一要執行的動作;階段狀態變更時請更新。]

## 目前階段

寫下目前正在處理的階段。

階段 1

## 各階段

將任務拆成三到七個可驗證的階段。每個狀態只能使用 `pending`、`in_progress` 或 `complete`,並在工作推進時更新。

### 階段 1:需求與發現

- [ ] 理解使用者意圖
- [ ] 確定約束條件和需求
- [ ] 將發現記錄到 findings.md
- **狀態:** in_progress

### 階段 2:規劃與結構

- [ ] 確定技術方案
- [ ] 如有需要,建立專案結構
- [ ] 記錄決策及理由
- **狀態:** pending

### 階段 3:實作

- [ ] 按計畫逐步執行
- [ ] 先將程式碼寫入檔案再執行
- [ ] 進行增量測試
- **狀態:** pending

### 階段 4:測試與驗證

- [ ] 驗證所有需求已滿足
- [ ] 將測試結果記錄到 progress.md
- [ ] 修復發現的問題
- **狀態:** pending

### 階段 5:交付

- [ ] 檢查所有輸出檔案
- [ ] 確保交付物完整
- [ ] 交付給使用者
- **狀態:** pending

## 關鍵問題

記錄重要問題,並在問題解決後以答案取代它們。

1. [待回答的問題]
2. [待回答的問題]

## 已做決策

記錄重要選擇及其理由。

| 決策 | 理由 |
|------|------|
|      |      |

## 遇到的錯誤

記錄每個不同的錯誤、嘗試次數與解決方式。再次嘗試失敗的動作前,先改變處理方法。

| 錯誤 | 嘗試次數 | 解決方案 |
|------|---------|---------|
|      | 1       |         |

## 備註

- 隨著工作推進,將階段狀態從 `pending` 更新為 `in_progress`,再更新為 `complete`。
- 做重大決策前,重新閱讀目標與下一步。
- 立即記錄錯誤,避免重複失敗的處理方式。
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall