planning-with-files-zh
基于 Manus 风格的文件规划系统，用于组织和跟踪复杂任务的进度。创建 task_plan.md、findings.md 和 progress.md 三个文件。当用户要求规划、拆解或组织多步骤项目、研究任务或需要超过5次工具调用的工作时使用。支持 /clear 后的自动会话恢复。触发词：任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目
npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zh --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 文件规划系统 像 Manus 一样工作：用持久化的 Markdown 文件作为你的「磁盘工作记忆」。 ## 第一步：恢复上下文（v2.2.0） **在做任何事之前**，检查规划文件是否存在并读取它们： 1. 如果 `task_plan.md` 存在，立即读取 `task_plan.md`、`progress.md` 和 `findings.md`。 2. 然后检查上一个会话是否有未同步的上下文： ```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" "$(pwd)" ``` ```powershell # Windows PowerShell & (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-zh\scripts\session-catchup.py" (Get-Location) ``` 如果恢复报告显示有未同步的上下文： 1. 运行 `git diff --stat` 查看实际代码变更 2. 读取当前规划文件 3. 根据恢复报告和 git diff 更新规划文件 4. 然后继续任务 ## 重要：文件存放位置 - **模板**在 `${CLAUDE_PLUGIN_ROOT}/templates/` 中 - **你的规划文件**放在**你的项目目录**中 | 位置 | 存放内容 | |------|---------| | 技能目录 (`${CLAUDE_PLUGIN_ROOT}/`) | 模板、脚本、参考文档 | | 你的项目目录 | `task_plan.md`、`findings.md`、`progress.md` | ## 快速开始 在任何复杂任务之前： 1. **创建 `task_plan.md`** — 参考 [templates/task_plan.md](templates/task_plan.md) 模板 2. **创建 `findings.md`** — 参考 [templates/findings.md](templates/findings.md) 模板 3. **创建 `progress.md`** — 参考 [templates/progress.md](templates/progress.md) 模板 4. **决策前重新读取计划** —
- 第一步：恢复上下文（v2.2.0）
- 重要：文件存放位置
- 快速开始
- 核心模式
- 文件用途
- 关键规则
- 1. 先创建计划
- 2. 两步操作规则
- 3. 决策前先读取
- 4. 行动后更新
- 5. 记录所有错误
- 6. 永远不要重复失败
- 7. 完成后继续
- 三次失败协议
Linux/macOS
What does the planning-with-files-zh skill do?
基于 Manus 风格的文件规划系统，用于组织和跟踪复杂任务的进度。创建 task_plan.md、findings.md 和 progress.md 三个文件。当用户要求规划、拆解或组织多步骤项目、研究任务或需要超过5次工具调用的工作时使用。支持 /clear 后的自动会话恢复。触发词：任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目
How do I install it?
Run `npx skills add OthmanAdi/planning-with-files --skill planning-with-files-zh --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From OthmanAdi/planning-with-files, a repository with 25,969 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.