المهارات planning-with-files
📦

planning-with-files

آمن ⚙️ الأوامر الخارجية

使用持久檔案規劃複雜任務

متاح أيضًا من: OthmanAdi,ZhanlinCui,AmmarCodes

漫長的 AI 工作階段會導致上下文丟失和目標遺忘。此技能使用 Markdown 檔案作為外部記憶體,以在無限的工具呼叫中維護任務狀態。

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "planning-with-files". Initialize planning for a Python CLI todo app with add, list, and delete commands

النتيجة المتوقعة:

  • Created task_plan.md with 5 phases: Requirements, Planning, Implementation, Testing, Delivery
  • Created findings.md with sections for requirements, research, and technical decisions
  • Created progress.md with session timestamp and initial status

استخدام "planning-with-files". Log error: FileNotFoundError when reading config.json

النتيجة المتوقعة:

  • Added to Errors Encountered table: FileNotFoundError, Attempt 1, Resolution: Create default config file
  • Updated progress.md error log with timestamp
  • Phase status remains in_progress until error resolved

التدقيق الأمني

آمن
v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

8
الملفات التي تم فحصها
1,146
الأسطر التي تم تحليلها
1
النتائج
1
إجمالي عمليات التدقيق

عوامل الخطر

تم تدقيقه بواسطة: claude

درجة الجودة

59
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
22
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

多步驟開發專案

透過階段追蹤、錯誤記錄和決策文件,在 50 次以上的工具呼叫中追蹤複雜的編碼任務。

研究與文件製作

在上下文丟失前,將網路搜尋結果、瀏覽器和來源資料擷取到結構化的 Markdown 中。

系統探索和除錯

在探索不熟悉的程式碼庫或除錯問題時,記錄發現、嘗試失敗的記錄和解決方案。

جرّب هذه الموجهات

初始化規劃工作階段
在我的專案目錄中建立 task_plan.md、findings.md 和 progress.md 檔案。目標是:[描述您的任務目標]。從第一階段開始收集需求。
追蹤錯誤修復進度
閱讀 task_plan.md 並更新目前階段的狀態。記錄遇到的錯誤:[貼上錯誤]。在錯誤記錄表中記錄根本原因和嘗試的修復方法。
擷取研究發現
我剛剛完成了兩個關於 [主題] 的網路搜尋。使用關鍵發現、相關 URL 和基於此研究所做的任何技術決策來更新 findings.md。
階段完成和審查
在 task_plan.md 中將第 [X] 階段標記為完成。總結完成的事項、建立或修改的檔案,並使用測試結果更新 progress.md。然後將第 [X+1] 階段設為進行中。

أفضل الممارسات

  • 在開始任何具有 3 個以上步驟的複雜任務前,先建立這三個規劃檔案
  • 在做出重大決定前閱讀 task_plan.md 以保持目標在注意力中
  • 每進行 2 次 view 或 browser 操作後立即更新 findings.md
  • 記錄每個遇到的錯誤,即使很快解決,也要防止重複
  • 明確標記階段狀態變更:pending 到 in_progress 到 complete

تجنب

  • 在先建立 task_plan.md 檔案的情況下開始執行
  • 在不記錄錯誤的情況下靜默重試失敗的動作
  • 重複相同的失敗動作而不是改變方法
  • 在技能目錄中建立規劃檔案而不是專案目錄
  • 使用 TodoWrite 進行持久化而不是基於檔案的儲存

الأسئلة المتكررة

我應該在哪裡建立規劃檔案?
在您正在工作的專案目錄中建立 task_plan.md、findings.md 和 progress.md,而不是在技能安裝資料夾中。這樣可以將規劃檔案與您的程式碼放在一起。
什麼時候應該更新規劃檔案?
每個階段完成後更新 task_plan.md。每進行 2 次 view 或 browser 操作後更新 findings.md。在整個工作階段中隨著動作完成持續更新 progress.md。
什麼是 2 動作規則?
每進行 2 次 view、browser 或搜尋操作後,立即將關鍵發現寫入 findings.md。這可以防止視覺或多模態資訊在上下文重置時遺失。
如何使用此技能處理錯誤?
在錯誤記錄表中記錄每個錯誤,並附上嘗試次數和解決方案。千萬不要重複相同的失敗動作。3 次失敗嘗試後,向使用者報告您嘗試過的內容。
我可以將其用於簡單的任務嗎?
對於簡單的問題、單一檔案編輯或快速查詢,請跳過規劃檔案。對於具有 3 個以上步驟的任務、研究專案或任何需要在多次工具呼叫中保持組織的任務,請使用此模式。
shell 指令稿的用途是什麼?
init-session.sh 使用範本內容建立所有三個規劃檔案。check-complete.sh 驗證 task_plan.md 中的所有階段是否都已標記為完成。兩者都是可選的自動化輔助工具。

تفاصيل المطور

بنية الملفات