planning-with-files-zh
A file-based planning system that uses persistent Markdown files (task_plan.md, findings.md, progress.md) as external memory for complex, multi-step AI tasks. It includes automated hooks to read and verify these files before and after tool usage to maintain context across sessions.
Is planning-with-files-zh safe to install?
Review the source first: our audit of planning-with-files-zh's source files found 17 shell commands, 0 external URLs, file reads and writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill executes shell commands to manage file state and performs automated file reads before every tool call. It is susceptible to indirect prompt injection if untrusted content is written into task_plan.md, as the skill automatically injects this file into the agent's context.
How we audit skills: our security review methodology.
Who is this skill for?
Users managing complex, multi-step projects, research tasks, or workflows requiring more than five tool calls who need to maintain state and progress tracking.
What can you do with it?
- Organizing and tracking progress for multi-step projects
- Conducting research tasks with persistent findings
- Managing complex workflows that exceed the AI's immediate context window
- Resuming interrupted tasks using automated session catch-up scripts
How good is this skill?
Quality score: 5/10. The skill provides a robust, well-documented framework for persistent state management. The security considerations regarding prompt injection are clearly defined and addressed through specific usage rules.
What does the skill file contain?
# 文件规划系统
像 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)...Frequently asked questions
Where should I store my planning files?
Store task_plan.md, findings.md, and progress.md in your project root directory, not in the skill installation directory.
How does the skill handle task recovery?
The skill uses a session-catchup.py script to identify un-synced context from previous sessions and prompts the user to verify changes via git diff.
What is the purpose of the attestation feature?
The attestation feature uses SHA-256 hashing to detect if the task_plan.md file has been tampered with or modified outside of the agent's control.
Why should I avoid writing web search results directly into task_plan.md?
task_plan.md is automatically read by the skill's hooks before every tool call. Storing untrusted external content there can lead to prompt injection.
Related skills
lark-drive
334.8KUsers needing to organize, manage, and govern files, folders, and documents within the Lark Suite or Doubao cloud storage ecosystem
The lark-drive skill provides comprehensive management for Lark Suite (Feishu) cloud storage, including file operations, folder organization, permission governance, and document version control. It handles file imports, exports, and metadata management while integrating with other specialized skills for content-specific tasks.
brainstorming
256.4KDevelopers and project managers who need to define requirements, architecture, and design for software projects before writing code
A structured brainstorming framework that guides users through project exploration, design proposal, and specification before implementation. It enforces a strict design-first workflow, requiring user approval for designs and documentation before transitioning to the writing-plans skill.
simple
221.4KDevelopers and project managers who need a fast, lightweight decision-making process for feature design or component creation
A structured brainstorming framework for architectural and creative tasks that guides users from discovery to decision-making through a defined process flow.
lark-workflow-meeting-summary
219.7KUsers who need to summarize meeting minutes, generate weekly reports, or review meeting history within the Lark ecosystem
The lark-workflow-meeting-summary skill provides a structured workflow for agents to aggregate meeting minutes from Lark VC, generate summaries, and create or update reports in Lark Docs.