planning-with-files-zh SKILL.md skillA
planning-with-files-zh from madnpc/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add madnpc/skills/planning-with-files-zh@v3.21.0-npc404.1Pins v3.21.0-npc404.1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- madnpc/skills
- Path
skills/planning-with-files-zh/SKILL.md- Versions recorded
- 5
- Latest version
- v3.21.0-npc404.1, committed Sep 29, 2026
- First version recorded
- Jul 2, 2026
- Size
- 10,291 bytes
- Repository stars
- 3
- License
- none declared
适用于需要跨会话持久追踪的复杂任务、研究或多阶段实施。自动恢复只读取项目规划文件；仅在用户明确要求时，session-catchup.py 才检查同项目会话元数据或输出受限且由 nonce 框定的不可信摘录。Use when work needs durable planning, coordination, or progress tracking across multiple steps or sessions. Do not use for small edits, simple explanations, copy changes, styling tweaks, or single-file fixes. 中文关键词：复杂任务、跨会话、任务规划、项目计划、分解任务、多步骤规划、复杂实现、实施计划、进度跟踪、文件规划、拆解项目。.
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 文件作为你的「磁盘工作记忆」。
## 输出语言
默认使用简体中文与用户沟通，并以简体中文创建规划、发现和进度文档。用户明确指定其他语言或既有文档语言另有约定时，遵从该约定；代码、命令、产品名和必须保持原文的引用不强行翻译。
## 本地目录约定
所有**新建**规划都放在 `docs/.planning/<plan-id>/`：
```
docs/.planning/
├── .active_plan
└── 2026-06-24-feature-name/
├── task_plan.md
├── findings.md
├── progress.md
└── .attestation
```
用 `scripts/init-session.sh "<topic>"` 或 `scripts/init-session.ps1 "<topic>"` 创建新规划。脚本会生成 `plan-id` 并写入 `docs/.planning/.active_plan`。解析顺序为：`PLAN_ID` 环境变量、`.active_plan`，最后是最新的有效规划目录。
恢复时复用选定规划，只补建缺失文件。并行任务必须在启动各宿主前设置各自的 `PLAN_ID`，或使用独立工作树；子进程里设置变量不会改变宿主环境。共享的 `.active_plan` 不代表会话绑定。共享计划与摘要由一个协调者维护，工作者只写分配的文件或自己的账本。
本地解析脚本仍保留回退行为，因此调用前必须核对显式 `PLAN_ID` 对应的目录和 `task_plan.md` 确实存在；无效时先修正选择，不得继续回退到其他任务。并行任务存在多个规划而尚未绑定时，先明确本任务的 `PLAN_ID`。读取解析结果后，再确认它与本任务选择一致。
旧的项目根目录规划仅在没有适用选择器或命名规划时兼容读取；不得再在根目录新建 `task_plan.md`、`findings.md` 或 `progress.md`。
## 第一步：恢复项目状态
**在做任何事之前**，用技能目录中的脚本解析并验证活动规划；将 `<skill-dir>` 替换为本技能目录：
```bash
PLAN_DIR="$(sh <skill-dir>/scripts/resolve-plan-dir.sh)"
sh <skill-dir>/scripts/verify-plan.sh
```
…Read the whole file at its exact version.
How to install
mdr add madnpc/skills/planning-with-files-zh@sha256:6af25c4161489a44The line at the top of this page pins the label v3.21.0-npc404.1, 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_km4whot3ueja4ap5)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 2, 2026 and Sep 29, 2026, about one every 22 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v3.21.0-npc404.1 latest | 2026-09-29 | 4fdade6 | 10,291 B | A | view · diff |
| v3.16.0-npc404.1 | 2026-09-05 | d7ecf7d | 9,556 B | A | view · diff |
| v3.8.2-npc404.1 | 2026-07-28 | 4ac4441 | 8,686 B | A | view · diff |
| v3.4.0-npc404.1 | 2026-07-07 | ef0d6f7 | 8,686 B | A | view · diff |
| v3.1.3-npc404.1 | 2026-07-02 | 4aaeb13 | 8,686 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 (10291 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
madnpc/skills · 3 stars · license none declared · pushed 2026-09-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_km4whot3ueja4ap5 GET https://markdownregistry.com/api/v1/resolve?ref=madnpc/skills/planning-with-files-zh GET https://markdownregistry.com/api/v1/blob/6af25c4161489a44a3cfa1534aacc517bfddc2cef129b3528ed2f2f8dc860868
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.