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.

Install it, pinned
mdr add othmanadi/planning-with-files/planning-with-files-zht@v3.28.0

Pins 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

The exact contents, by fingerprint
mdr add othmanadi/planning-with-files/planning-with-files-zht@sha256:5e62e75794fafb8e

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ixp623u7dfgnjaih.svg)](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.

versioncommittedcommitsizeaudit
v3.28.0 latest2026-11-03 7db1881 14,910 BA view · diff
v3.27.02026-11-03 49a6a58 14,910 BA view · diff
v3.27.02026-10-30 a13b6be 14,455 BA view · diff
v3.26.02026-10-30 bafd623 14,455 BA view · diff
v3.26.02026-10-28 5d29800 14,192 BA view · diff
v3.25.12026-10-24 7e134c7 14,192 BA view · diff
v3.25.22026-10-24 dcdfb27 14,192 BA view · diff
v3.25.12026-10-23 99402ce 13,176 BA view · diff
v3.25.02026-10-20 de837a9 13,176 BA view · diff
v3.24.32026-10-17 d363544 13,176 BA view · diff
v3.24.22026-10-17 4e76b40 13,176 BA view · diff
v3.24.12026-10-16 6b30f32 13,176 BA view · diff
v3.24.02026-10-10 7056ed2 13,176 BA view · diff
v3.23.02026-10-06 41f60ae 13,176 BA view · diff
v3.22.02026-10-01 dab9d16 13,176 BA view · diff
v3.21.02026-09-27 51c1caa 13,176 BA view · diff
v3.20.82026-09-25 4d24d9a 13,176 BA view · diff
v3.20.72026-09-23 3b7690e 13,176 BA view · diff
v3.20.62026-09-23 3827d3c 13,176 BA view · diff
v3.20.52026-09-21 b81c488 13,176 BA view · diff
v3.20.42026-09-19 726da18 13,176 BA view · diff
v3.20.32026-09-19 57fe376 13,176 BA view · diff
v3.20.22026-09-19 f01a88a 13,176 BA view · diff
v3.20.12026-09-18 faf1a15 13,176 BA view · diff
v3.20.02026-09-17 2fbbd77 13,176 BA view · diff
v3.19.02026-09-17 7a0a020 13,176 BA view · diff
v3.18.32026-09-16 746f57a 13,176 BA view · diff
v3.18.22026-09-16 f12e714 13,176 BA view · diff
v3.18.12026-09-15 7c11cb7 13,176 BA view · diff
v3.18.02026-09-13 10d4a58 13,176 BA view · diff
v3.17.22026-09-13 ae7e3ae 13,176 BA view · diff
v3.17.22026-09-09 f67e2bb 12,594 BA view · diff
v3.17.12026-09-08 5046267 12,594 BA view · diff
v3.17.02026-09-07 0d21b6c 12,594 BA view · diff
v3.16.12026-09-05 8dd1e3f 12,594 BA view · diff
v3.16.02026-09-05 91b152c 12,594 BA view · diff
v3.16.02026-09-02 0fb6759 12,610 BA view · diff
v3.15.02026-09-02 601df17 12,610 BA view · diff
v3.14.02026-09-02 a3e7b8b 12,610 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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.

More from othmanadi/planning-with-files

planning-with-files SKILL.md skill
othmanadi/planning-with-files · .agents/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .codebuddy/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .codex/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .continue/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v2.43.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .cursor/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .factory/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .gemini/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v2.43.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .hermes/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .kiro/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.0.1-kiro · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .mastracode/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .opencode/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars
planning-with-files SKILL.md skill
othmanadi/planning-with-files · .pi/skills/planning-with-files/SKILL.md · Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk…
v3.28.0 · audit A · 27,905 stars

Every file in othmanadi/planning-with-files

Browse by kind, by grade A, or by owner.