Planning With Files Zh

What it does

When your agent uses it

• Tasks that involve Planning
• Tasks that involve Internationalization

Example prompts

• “/planning-with-files-zh”

Requirements

• Python 3
• A Bash shell
• PowerShell
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep

Workflow steps

7 steps, taken from the step headings in SKILL.md.

1. 1先创建计划
2. 2两步操作规则
3. 3决策前先读取
4. 4行动后更新
5. 5记录所有错误
6. 6永远不要重复失败
7. 7完成后继续

What it can do on your machine

Read from SKILL.md and the folder at commit 7056ed2. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash
  • Glob
  • Grep

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 19 files in scripts/ (Shell, PowerShell and Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • git
  • sh

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Planning With Files Zh loads about 2.1k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 242 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~84

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from OthmanAdi/planning-with-files at commit 7056ed2, republished under its MIT licence (© OthmanAdi). 242 words, ~2,126 tokens.

name

planning-with-files-zh

description

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

allowed-tools

Read, Write, Edit, Bash, Glob, Grep

user-invocable

true

metadata.version

3.24.0

# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-zh}"
# 仅显示同项目的汇总计数，不显示会话摘录
$(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-zh\scripts\session-catchup.py" --metadata (Get-Location)
# 只有在用户明确同意后，才将 --metadata 改为 --replay。

上下文窗口 = 内存（易失性，有限）
文件系统 = 磁盘（持久性，无限）

→ 任何重要的内容都写入磁盘。

## 遇到的错误
| 错误 | 尝试次数 | 解决方案 |
|------|---------|---------|
| FileNotFoundError | 1 | 创建了默认配置 |
| API 超时 | 2 | 添加了重试逻辑 |

if 操作失败:
    下一步操作 != 同样的操作

第1次尝试：诊断并修复
  → 仔细阅读错误
  → 找到根本原因
  → 针对性修复

第2次尝试：替代方案
  → 同样的错误？换一种方法
  → 不同的工具？不同的库？
  → 绝不重复完全相同的失败操作

第3次尝试：重新思考
  → 质疑假设
  → 搜索解决方案
  → 考虑更新计划

3次失败后：向用户求助
  → 说明你尝试了什么
  → 分享具体错误
  → 请求指导

© OthmanAdi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 26 other files (scripts) in skills/i18n/planning-with-files-zh of OthmanAdi/planning-with-files.

• SKILL.md
• scripts/attest-plan.ps1
• scripts/attest-plan.sh
• scripts/check-complete.ps1
• scripts/check-complete.sh
• scripts/gate-stop.sh
• scripts/init-session.ps1
• scripts/init-session.sh
• scripts/inject-plan.py
• scripts/inject-plan.sh
• scripts/ledger-append.ps1
• scripts/ledger-append.sh
• scripts/ledger-summary.ps1
• scripts/ledger-summary.sh
• scripts/phase-status.ps1
• scripts/phase-status.sh
• scripts/plan-doctor.sh
• scripts/resolve-plan-dir.ps1
• scripts/resolve-plan-dir.sh
• scripts/session-catchup.py
• … and 7 more

Open the folder on GitHubat commit 7056ed2