OthmanAdi/planning-with-files
⭐ 20,746 · #1 · Python
Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.
Python adal agent-skills antigravity Skill
项目分析
| 🎯 定位 | Agent 能力增强 |
| 💡 核心价值 | 为 AI 编码 Agent 提供标准化的 Skills 和 Prompt 模板，覆盖特定场景（代码审查、调试、架构设计等），让 Agent 在这些场景下输出质量更高 |
| 👥 适合谁 | 使用 Claude Code/Cursor/Codex 等 Agent 工具的开发者，想提升 Agent 在特定任务上的表现 |
为什么值得关注
20,746 Stars，社区活跃度不错，说明解决了真实痛点。使用 Python 开发。
将 Manus 风格规划转化为可复用的 Claude Code 技能。
核心功能
- Markdown 文件即规划：以
.md文件作为规划载体，实现 AI Agent 的任务分解与执行跟踪，无需复杂数据库。 - Manus 工作流复刻：完整复现了价值 20 亿美元收购案背后的核心规划模式——持久化、可迭代的步骤管理。
- 多 Agent 框架兼容：除 Claude Code 外，还适配 Copilot、Mastra、OpenClaw 等主流 Agent 框架，降低迁移成本。
- 轻量级技能封装：以
skill形式存在，非独立应用，可直接注入现有 Agent 工作流，零侵入。 - 状态持久化：规划文件支持进度标记、任务完成状态记录，支持中断后恢复执行。
技术架构
- 技术栈：纯 Python 实现，依赖极少，核心逻辑围绕文件 I/O 和 Markdown 解析。
- 代码结构：
skills/目录按 Agent 框架分类（claude/、copilot/、mastra/ 等），每个子目录包含独立的 skill 定义文件。 - 设计亮点：
- 采用“规划即文件”模式，将状态管理从内存/数据库下沉到文件系统，极大简化部署复杂度。
- 通过统一的 Markdown 模板格式，实现跨框架的规划定义复用。
- 无外部依赖，仅依赖 Python 标准库，体现了“少即是多”的设计哲学。
快速上手指南
- 克隆仓库：
git clone https://github.com/OthmanAdi/planning-with-files.git - 选择框架：进入对应目录，如
cd planning-with-files/skills/claude/ - 注入技能：将
planning.md文件复制到 Agent 的工作目录 - 启动 Agent：在 Claude Code 中加载该技能文件，即可开始使用规划功能
- 自定义规划：修改
.md文件中的任务列表，Agent 会自动识别并执行
优劣势与适用场景
优势
- 极低心智负担：无需学习新工具，Markdown 即规划，文件即状态。
- 框架无关性：一套规划模板适配多种 Agent 框架，减少重复工作。
- 轻量可审计：所有规划以文件形式存在，可版本控制、可人工审查。
劣势
- 单机局限：文件级状态管理不适合分布式、多 Agent 协作场景。
- 功能边界：缺乏高级规划特性（如依赖图、资源调度、动态重规划）。
- 生态依赖：需配合特定 Agent 框架使用，非独立解决方案。
适用场景
- 个人开发者：快速搭建 AI 辅助的 Task 管理系统。
- 小团队：在 Claude Code 等 Agent 工具中实现可追踪的规划工作流。
- 原型验证：验证“规划即文件”模式在具体业务中的可行性。
社区与热度
- Star 数量：20,746，增长迅猛，反映出市场对 Manus 模式复用的强烈需求。
- 更新活跃度：最后一次更新在 2026 年 5 月，项目仍处于持续迭代中。
- 话题热度：覆盖
adal、agent-skills、manus、mastra等热门 Agent 话题，社区关注度高。 - Fork 趋势：活跃的 Fork 数量表明有大量开发者基于此项目进行二次开发和定制。
评价：该项目精准抓住了 AI Agent 领域“规划能力”这一痛点，以极简技术方案实现了高价值工作流的复刻。虽不是通用框架，但作为技能组件，其设计思路和实用性值得参考。
技术信息
- 💻 语言: Python
- 📂 Topics: adal, agent-skills, antigravity, claude, claude-code
- 🕐 更新: 2026-02-12
- 🔗 访问 GitHub 仓库
数据更新于 2026-03-09 · Stars 数以 GitHub 实际数据为准