planning-with-files-zht SKILL.md skillA
planning-with-files-zht from othmanadi/planning-with-files is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add othmanadi/planning-with-files/planning-with-files-zht@v3.28.0Pins v3.28.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- othmanadi/planning-with-files
- Path
skills/i18n/planning-with-files-zht/SKILL.md- Versions recorded
- 39
- Latest version
- v3.28.0, committed Nov 3, 2026
- First version recorded
- Sep 2, 2026
- Size
- 14,910 bytes
- Repository stars
- 27,905
- License
- MIT
用於多步驟 AI 代理工作的持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上,生命週期鉤子會注入選定的專案規劃內容。自動恢復只讀取專案規劃檔案;只有明確執行 session-catchup.py --metadata 才會檢查本機同一專案的代理工作階段中繼資料,--replay 則會輸出有界且以 nonce 框定的摘錄。選用的閘門模式只會在主機支援時要求繼續,而且絕不執行 Markdown 中宣告的命令。此技能沒有網路上傳路徑。適用於研究或需要超過 5 次工具呼叫的工作。觸發詞:任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 檔案規劃系統
像 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。
```
…Read the whole file at its exact version.
How to install
mdr add othmanadi/planning-with-files/planning-with-files-zht@sha256:5e62e75794fafb8eThe line at the top of this page pins the label v3.28.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_ixp623u7dfgnjaih)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 39 versions of this file, between Sep 2, 2026 and Nov 3, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v3.28.0 latest | 2026-11-03 | 7db1881 | 14,910 B | A | view · diff |
| v3.27.0 | 2026-11-03 | 49a6a58 | 14,910 B | A | view · diff |
| v3.27.0 | 2026-10-30 | a13b6be | 14,455 B | A | view · diff |
| v3.26.0 | 2026-10-30 | bafd623 | 14,455 B | A | view · diff |
| v3.26.0 | 2026-10-28 | 5d29800 | 14,192 B | A | view · diff |
| v3.25.1 | 2026-10-24 | 7e134c7 | 14,192 B | A | view · diff |
| v3.25.2 | 2026-10-24 | dcdfb27 | 14,192 B | A | view · diff |
| v3.25.1 | 2026-10-23 | 99402ce | 13,176 B | A | view · diff |
| v3.25.0 | 2026-10-20 | de837a9 | 13,176 B | A | view · diff |
| v3.24.3 | 2026-10-17 | d363544 | 13,176 B | A | view · diff |
| v3.24.2 | 2026-10-17 | 4e76b40 | 13,176 B | A | view · diff |
| v3.24.1 | 2026-10-16 | 6b30f32 | 13,176 B | A | view · diff |
| v3.24.0 | 2026-10-10 | 7056ed2 | 13,176 B | A | view · diff |
| v3.23.0 | 2026-10-06 | 41f60ae | 13,176 B | A | view · diff |
| v3.22.0 | 2026-10-01 | dab9d16 | 13,176 B | A | view · diff |
| v3.21.0 | 2026-09-27 | 51c1caa | 13,176 B | A | view · diff |
| v3.20.8 | 2026-09-25 | 4d24d9a | 13,176 B | A | view · diff |
| v3.20.7 | 2026-09-23 | 3b7690e | 13,176 B | A | view · diff |
| v3.20.6 | 2026-09-23 | 3827d3c | 13,176 B | A | view · diff |
| v3.20.5 | 2026-09-21 | b81c488 | 13,176 B | A | view · diff |
| v3.20.4 | 2026-09-19 | 726da18 | 13,176 B | A | view · diff |
| v3.20.3 | 2026-09-19 | 57fe376 | 13,176 B | A | view · diff |
| v3.20.2 | 2026-09-19 | f01a88a | 13,176 B | A | view · diff |
| v3.20.1 | 2026-09-18 | faf1a15 | 13,176 B | A | view · diff |
| v3.20.0 | 2026-09-17 | 2fbbd77 | 13,176 B | A | view · diff |
| v3.19.0 | 2026-09-17 | 7a0a020 | 13,176 B | A | view · diff |
| v3.18.3 | 2026-09-16 | 746f57a | 13,176 B | A | view · diff |
| v3.18.2 | 2026-09-16 | f12e714 | 13,176 B | A | view · diff |
| v3.18.1 | 2026-09-15 | 7c11cb7 | 13,176 B | A | view · diff |
| v3.18.0 | 2026-09-13 | 10d4a58 | 13,176 B | A | view · diff |
| v3.17.2 | 2026-09-13 | ae7e3ae | 13,176 B | A | view · diff |
| v3.17.2 | 2026-09-09 | f67e2bb | 12,594 B | A | view · diff |
| v3.17.1 | 2026-09-08 | 5046267 | 12,594 B | A | view · diff |
| v3.17.0 | 2026-09-07 | 0d21b6c | 12,594 B | A | view · diff |
| v3.16.1 | 2026-09-05 | 8dd1e3f | 12,594 B | A | view · diff |
| v3.16.0 | 2026-09-05 | 91b152c | 12,594 B | A | view · diff |
| v3.16.0 | 2026-09-02 | 0fb6759 | 12,610 B | A | view · diff |
| v3.15.0 | 2026-09-02 | 601df17 | 12,610 B | A | view · diff |
| v3.14.0 | 2026-09-02 | a3e7b8b | 12,610 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14910 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
othmanadi/planning-with-files · 27,905 stars · license MIT · pushed 2026-11-04 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_ixp623u7dfgnjaih GET https://markdownregistry.com/api/v1/resolve?ref=othmanadi/planning-with-files/planning-with-files-zht GET https://markdownregistry.com/api/v1/blob/5e62e75794fafb8e7623cb47a789bfebbd1a88c2c73f0098e12478f8e20e7b9c
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.