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

planning-with-files

آمن ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة📁 الوصول إلى نظام الملفات

使用檔案規劃複雜任務

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

AI 代理在執行長時間任務時容易失去目標追蹤。此技能使用持續性的 markdown 檔案作為外部記憶,讓代理能夠處理複雜的多步驟專案而不失去上下文。

يدعم: Claude Codex Code(CC)
🥈 80 فضي
1

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "planning-with-files". 研究晨間運動的好處並撰寫摘要

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

已建立 task_plan.md,包含階段:建立規劃、搜尋來源、綜合發現、交付摘要。第 1 階段完成。準備搜尋來源。

استخدام "planning-with-files". 修復認證模組中的登入錯誤

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

已建立 task_plan.md,包含階段:理解錯誤、定位程式碼、識別根本原因、實作修復、測試。目前在第 3 階段 - 已找到根本原因。

استخدام "planning-with-files". 在設定頁面新增深色模式切換器

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

已建立 task_plan.md、包含現有主題系統分析的 findings.md,以及 progress.md。第 1 階段完成 - 已識別要修改的主題檔案。

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

آمن
v1 • 2/24/2026

Static analysis flagged 101 potential issues but evaluation confirms all are FALSE POSITIVES. The detected external_commands are markdown documentation examples showing AI tool usage, not actual shell execution. Network access is limited to a single legitimate reference URL. Filesystem access is standard file operations. The skill implements Manus-style planning methodology with no malicious intent. Safe for publication.

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

عوامل الخطر

⚙️ الأوامر الخارجية (78)
🌐 الوصول إلى الشبكة (2)
📁 الوصول إلى نظام الملفات (1)

الأنماط المكتشفة

External Commands (Markdown Documentation Examples)Hardcoded URL (Reference Link)Browser Storage Access (Documentation Example)Critical Heuristic: Code Execution + Network + Credentials
تم تدقيقه بواسطة: claude

درجة الجودة

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

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

研究專案

使用 task_plan.md 追蹤研究階段,使用 findings.md 儲存發現,使用 progress.md 記錄工作階段活動。防止遺失來源和洞察。

錯誤修復

建立任務規劃,包含診斷、根本原因識別、修復實作和測試階段。追蹤遇到的錯誤以避免重複失敗的方法。

功能開發

規劃功能實作的各個階段,將設計決策儲存在 findings.md 中,並在整個開發過程中記錄進度。在許多實作步驟中保持專注。

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

基礎任務規劃
建立一個 task_plan.md 檔案,包含以下階段:[描述你的任務]。使用 planning-with-files 技能結構。
帶有發現的研究
為關於 [主題] 的研究任務設定規劃檔案。建立包含階段的 task_plan.md、用於儲存來源的 findings.md,以及用於記錄的 progress.md。
除錯工作階段
使用 planning-with-files 來除錯 [問題]。建立包含診斷階段的 task_plan.md,在規劃中追蹤錯誤,並在發現根本原因時記錄發現。
完整專案工作流程
應用完整的 planning-with-files 工作流程:建立所有三個規劃檔案,實作 2-action 規則,使用 3-strike 錯誤協議,並應用 read-before-decide 模式。

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

  • 在開始任何超過 5 次工具調用的複雜任務之前建立 task_plan.md
  • 在做出重大決策之前重新閱讀規劃檔案,以在上下文中刷新目標
  • 在每個階段之後更新 task_plan.md 以追蹤進度並標記完成狀態

تجنب

  • 使用 TodoWrite 進行持久化而不是建立 task_plan.md 檔案
  • 在未先建立規劃檔案的情況下立即開始執行
  • 隱藏錯誤並靜默默認重試,而不是記錄到規劃檔案

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

我應該在哪裡建立規劃檔案?
在專案目錄中建立 task_plan.md、findings.md 和 progress.md,而不是在技能安裝資料夾中。這讓你的規劃檔案與程式碼放在一起。
我應該何時使用此技能?
對於需要超過 5 次工具調用、研究專案、多步驟實作或任何需要組織的任務,使用 planning-with-files。
什麼是 2-action 規則?
在每 2 次 view、browser 或 search 操作後,立即將關鍵發現儲存到檔案。這可以防止視覺和多模式資訊遺失。
3-strike 錯誤協議如何運作?
嘗試 1:診斷並修復。嘗試 2:嘗試替代方法。嘗試 3:更廣泛的重新思考。3 次失敗後:向使用者升級並說明你嘗試過的方法。
什麼是 read-before-decide 模式?
在重大決策之前,閱讀 task_plan.md 以將目標帶回你的注意力視窗。這可以防止在長時間任務中失去對原始目標的追蹤。
什麼是 KV-cache 以及為什麼它很重要?
KV-cache 是一種用於快取已計算 token 的機制。高命中率可顯著降低成本(便宜 10 倍)。穩定的提示詞可維持快取有效性。

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

بنية الملفات