📦

planning-with-files

Name: planning-with-files
Author: sickn33

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

Komplexe Aufgaben mit persistenten Dateien planen

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

Lange AI-Sitzungen verursachen Kontextverlust und vergessene Ziele. Diese Fähigkeit verwendet Markdown-Dateien als externes Gedächtnis, um den Aufgabenstatus über unbegrenzte Tool-Aufrufe hinweg aufrechtzuerhalten.

يدعم: Claude Codex Code(CC)

🥈 79 فضي

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

رفع في Claude

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

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

اختبرها

استخدام "planning-with-files". Planung für eine Python-CLI-Todo-App mit add-, list- und delete-Befehlen initialisieren

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

task_plan.md mit 5 Phasen erstellt: Requirements, Planning, Implementation, Testing, Delivery
findings.md mit Abschnitten für Anforderungen, Recherche und technische Entscheidungen erstellt
progress.md mit Sitzungszeitstempel und initialem Status erstellt

استخدام "planning-with-files". Fehler protokollieren: FileNotFoundError beim Lesen von config.json

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

Zur Tabelle Errors Encountered hinzugefügt: FileNotFoundError, Versuch 1, Lösung: Standard-Konfigurationsdatei erstellen
progress.md Fehlerprotokoll mit Zeitstempel aktualisiert
Phasenstatus bleibt in_progress, bis Fehler behoben

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

آمن

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.

الملفات التي تم فحصها

1,146

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

عوامل الخطر

⚙️ الأوامر الخارجية (2)

scripts/check-complete.sh:1-45 scripts/init-session.sh:1-121

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

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

100

الأمان

الامتثال للمواصفات

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

Mehrstufige Entwicklungsprojekte

Verfolgung komplexer Coding-Aufgaben über 50+ Tool-Aufrufe mit Phasentracking, Fehlerprotokollierung und Entscheidungsdokumentation.

Forschung und Dokumentation

Erfassung von Web-Suchergebnissen, Browser-Ergebnissen und Quellenmaterial in strukturiertem Markdown, bevor der Kontext verloren geht.

Systemexploration und Debugging

Dokumentation von Entdeckungen, fehlgeschlagenen Versuchen und Lösungen bei der Exploration unbekannter Codebasen oder beim Debuggen von Problemen.

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

Planungssitzung initialisieren

Erstellen Sie task_plan.md, findings.md und progress.md Dateien in meinem Projektverzeichnis. Das Ziel ist: [Beschreiben Sie Ihr Aufgabenziel]. Beginnen Sie mit Phase 1 für die Anforderungsermittlung.

Bug-Fix-Fortschritt verfolgen

Lesen Sie task_plan.md und aktualisieren Sie den aktuellen Phasenstatus. Protokollieren Sie den aufgetretenen Fehler: [Fehler einfügen]. Dokumentieren Sie die Grundursache und versuchten Fixes in der Tabelle Errors Encountered.

Forschungsergebnisse erfassen

Ich habe gerade zwei Websuchen zu [Thema] abgeschlossen. Aktualisieren Sie findings.md mit den wichtigsten Entdeckungen, relevanten URLs und technischen Entscheidungen, die aufgrund dieser Recherche getroffen wurden.

Phasenabschluss und Überprüfung

Markieren Sie Phase [X] in task_plan.md als abgeschlossen. Fassen Sie zusammen, was erledigt wurde, welche Dateien erstellt oder geändert wurden, und aktualisieren Sie progress.md mit Testergebnissen. Setzen Sie dann Phase [X+1] auf in_progress.

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

Erstellen Sie alle drei Planungsdateien vor dem Start einer komplexen Aufgabe mit 3+ Schritten
Lesen Sie task_plan.md vor wichtigen Entscheidungen, um Ziele im Fokus zu behalten
Aktualisieren Sie findings.md sofort nach jeweils 2 view- oder browser-Operationen
Protokollieren Sie jeden aufgetretenen Fehler, auch wenn schnell behoben, um Wiederholungen zu verhindern
Markieren Sie Phasenstatusänderungen explizit: pending zu in_progress zu complete

تجنب

Ausführung starten, ohne zuerst eine task_plan.md-Datei zu erstellen
Fehlgeschlagene Aktionen stillschweigend wiederholen, ohne den Fehler zu protokollieren
Dieselbe fehlgeschlagene Aktion wiederholen, anstatt den Ansatz zu ändern
Planungsdateien im Skill-Verzeichnis statt im Projektverzeichnis erstellen
TodoWrite für Persistenz verwenden statt dateibasierter Speicherung

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

Wo soll ich die Planungsdateien erstellen?

Erstellen Sie task_plan.md, findings.md und progress.md in Ihrem Projektverzeichnis, in dem Sie arbeiten, nicht im Skill-Installationsordner. Dies hält Planungsdateien neben Ihrem Code.

Wann soll ich die Planungsdateien aktualisieren?

Aktualisieren Sie task_plan.md nach Abschluss jeder Phase. Aktualisieren Sie findings.md nach jeweils 2 view- oder browser-Operationen. Aktualisieren Sie progress.md während der gesamten Sitzung, wenn Aktionen abgeschlossen werden.

Was ist die 2-Aktionen-Regel?

Nach jeweils 2 view-, browser- oder search-Operationen sofort wichtige Erkenntnisse in findings.md schreiben. Dies verhindert, dass visuelle oder multimodale Informationen beim Kontext-Reset verloren gehen.

Wie gehe ich mit Fehlern bei dieser Fähigkeit um?

Protokollieren Sie jeden Fehler in der Tabelle Errors Encountered mit Versuchsnummer und Lösung. Wiederholen Sie niemals dieselbe fehlgeschlagene Aktion. Nach 3 fehlgeschlagenen Versuchen eskalieren Sie zum Benutzer mit den durchgeführten Versuchen.

Kann ich dies für einfache Aufgaben verwenden?

Für einfache Fragen, Einzel-Datei-Bearbeitungen oder schnelle Nachschlagen überspringen Sie die Planungsdateien. Verwenden Sie dieses Muster für Aufgaben mit 3+ Schritten, Forschungsprojekte oder alles, was Organisation über viele Tool-Aufrufe hinweg erfordert.

Wofür sind die Shell-Skripte?

init-session.sh erstellt alle drei Planungsdateien mit Vorlageninhalt. check-complete.sh überprüft, ob alle Phasen in task_plan.md als complete markiert sind. Beide sind optionale Helfer für die Automatisierung.