
Planning With Files Zht
This is a structured file-based planning system inspired by Manus that treats your filesystem as persistent memory. It creates three markdown files in your project directory: task_plan.md for phases and progress, findings.md for research discoveries, and progress.md for session logs. The hooks automatically inject plan context before tool use and remind you to update progress after edits. There's a two-step rule: after every two browser or search operations, save key findings to disk immediately because multimodal content doesn't persist in context. It includes session recovery scripts to catch up after /clear commands. The security boundary is worth noting: task_plan.md gets auto-injected frequently, so only write trusted content there and keep external web scraping results in findings.md. Use this for any multi-step task requiring more than five tool calls.
- skills.sh installs
- 7.9K
- GitHub stars
- 28K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add othmanadi/planning-with-files --skill planning-with-files-zht --agent claude-codeInstalls into .claude/skills of the current project.
Files
檔案規劃系統
像 Manus 一樣工作:用持久化的 Markdown 檔案作為你的「磁碟工作記憶」。
第一步:恢復專案狀態
繼續之前,先解析此任務所屬的計畫目錄:
- 使用已安裝的
scripts/resolve-plan-dir.sh(或.ps1),配合主機的PLAN_ID與PWF_PLAN_ROOT,從這一個選定目錄讀取task_plan.md、progress.md和findings.md。 - 若明確選擇器被拒絕,或工作階段隔離已啟用且有多個計畫卻沒有
PLAN_ID,請修正釘選,不要退回另一項任務。只有沒有適用的選擇器或具名計畫時,才使用專案根目錄的舊檔案。 - 執行
git diff --stat,查看尚未記錄的程式碼變更。
下列所有規劃檔案名稱都指向這個選定目錄。平行任務時,請在啟動每個主機前釘選它,或使用獨立 worktree;在子程序中匯出變數不會改變主機環境。一位協調者擁有共享計畫與摘要,工作者使用指派的檔案或帳本。
自動恢復到此為止。未指定模式的 session-catchup.py 與生命週期鉤子不會檢查代理工作階段儲存區。只有在使用者明確要求查閱本機工作階段歷史時,才能選擇下列模式:
# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-zht}"
# 只顯示同一專案的項目數,不輸出逐字稿摘錄
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --metadata "$(pwd)"
# 明確要求的限量重播,以 nonce 框定同一專案的摘錄
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --replay "$(pwd)"
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zht\scripts\session-catchup.py" --metadata (Get-Location)
# 只有在使用者明確同意後,才能將 --metadata 改為 --replay。
Sponsors
Details
- Repository
- github.com/othmanadi/planning-with-files
- Category
- Productivity & Planning
- First seen
- Apr 16, 2026