planning-with-files-zh SKILL.md skillA

planning-with-files-zh 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-zh@v3.25.0

Pins v3.25.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-zh/SKILL.md

Versions recorded

31

Latest version

v3.25.0, committed Oct 20, 2026

First version recorded

Sep 2, 2026

Size

13,119 bytes

Repository stars

27,556

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`，确认尚未记录的代码变更。

下文所有规划文件名都指向这个选定目录。并行任务时，在启动每个主机前固定它，或使用独立工作树；在子进程中导出变量不会改变主机环境。一个协调者拥有共享计划和摘要，工作者使用分配的文件或账本。

自动恢复到此为止。无参数运行 `session-catchup.py` 以及生命周期钩子都不会检查代理的会话存储。只有在用户明确要求查阅本机会话历史时，才选择以下模式之一：

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

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

Read the whole file at its exact version.

How to install

mdr add othmanadi/planning-with-files/planning-with-files-zh@sha256:307a8da314ffb734

[![mdr](https://markdownregistry.com/badge/art_3jrj7m2cs5wbq755.svg)](https://markdownregistry.com/a/art_3jrj7m2cs5wbq755)

Versions

The registry has recorded 31 versions of this file, between Sep 2, 2026 and Oct 20, 2026, about one every 2 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_3jrj7m2cs5wbq755
GET https://markdownregistry.com/api/v1/resolve?ref=othmanadi/planning-with-files/planning-with-files-zh
GET https://markdownregistry.com/api/v1/blob/307a8da314ffb7343f1177af51fd9dde2e40c69d91bc430bc2b07e5b65ed83ce

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

Every file in othmanadi/planning-with-files

Other files named planning-with-files-zh

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