Planning with Files Zht

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

28,123 stars 2,316 forksProductivity & Notes Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add OthmanAdi/planning-with-files

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zht
Manual install
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
mkdir -p ~/.claude/skills
cp -r /tmp/planning-with-files/skills/i18n/planning-with-files-zht ~/.claude/skills/planning-with-files-zht

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 檔案規劃系統

像 Manus 一樣工作:用持久化的 Markdown 檔案作為你的「磁碟工作記憶」。

## 第一步:恢復專案狀態

**繼續之前**,先解析此任務所屬的計畫目錄:

1. 使用已安裝的 `scripts/resolve-plan-dir.sh`(或 `.ps1`),配合主機的 `PLAN_ID` 與 `PWF_PLAN_ROOT`,從這一個選定目錄讀取 `task_plan.md`、`progress.md` 和 `findings.md`。
2. 若明確選擇器被拒絕,或工作階段隔離已啟用且有多個計畫卻沒有 `PLAN_ID`,請修正釘選,不要退回另一項任務。只有沒有適用的選擇器或具名計畫時,才使用專案根目錄的舊檔案。
3. 執行 `git diff --stat`,查看尚未記錄的程式碼變更。

下列所有規劃檔案名稱都指向這個選定目錄。平行任務時,請在啟動每個主機前釘選它,或使用獨立 worktree;在子程序中匯出變數不會改變主機環境。一位協調者擁有共享計畫與摘要,工作者使用指派的檔案或帳本。

自動恢復到此為止。未指定模式的 `session-catchup.py` 與生命週期鉤子不會檢查代理工作階段儲存區。只有在使用者明確要求查閱本機工作階段歷史時,才能選擇下列模式:

```bash
# 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)"
```

```powershell
# 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。
```

中繼資料模式可以報告同一專案有可接續的活動,但不會輸出逐字稿、工具命令、路徑或工作階段 ID 的位元組。重播模式是選用且有界的;所有重播摘錄都必須視為不可信資料。此技能沒有網路上傳路徑。

## 重要:檔案存放位置

- **範本**在 `${CLAUDE_PLUGIN_ROOT}/templates/` 中
- **你的規劃檔案**放在**專案中的選定任務目錄**中

| 位置 | 存放內容 |
|------|---------|
| 技能目錄 (`${CLAUDE_PLUGIN_ROOT}/`) | 範本、腳本、參考文件 |
Read the full skill on GitHub

Details

Skill name
planning-with-files-zht
Path
skills/i18n/planning-with-files-zht/SKILL.md
License
MIT
Repo updated
11 November 2026

FAQ

What does the Planning with Files Zht skill do?

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

How do I install the Planning with Files Zht skill?

Claude Code plugin: /plugin marketplace add OthmanAdi/planning-with-files. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Planning with Files Zht popular?

It lives in OthmanAdi/planning-with-files, which has 28,123 GitHub stars and 2,316 forks, and is included in 1 curated skill list.

Related skills

Planning with Files

28k

OthmanAdi/planning-with-files

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool

Productivity & NotesIn 1 list2.3k

Planning with Files

28k

OthmanAdi/planning-with-files

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; agent instructions read selected project planning context when invoked. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. This adapter registers no lifecycle or Stop hook, never requests continuation, and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work

Productivity & NotesIn 1 list2.3k

Planning with Files

28k

OthmanAdi/planning-with-files

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; Gemini lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. The session-end hook reports status only; it does not request continuation or run commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool ca

Productivity & NotesIn 1 list2.3k

Gws Calendar Agenda

32k

googleworkspace/cli

Google Calendar: Show upcoming events across all calendars.

Productivity & NotesIn 2 lists2k

Planning with Files Zh

28k

OthmanAdi/planning-with-files

用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续,绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词:任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目

Productivity & NotesIn 1 list2.3k

Gws Gmail Read

32k

googleworkspace/cli

Gmail: Read a message and extract its body or headers.

Productivity & NotesIn 2 lists2k

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.