阶段1需求分析与研究【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files理解用户需求研究现有解决方案状态:in_progress阶段2技术架构设计设计数据库模式定义API接口状态:pending依赖:阶段1### 步骤4实施2-Action规则 这是Manus工作法的关键原则**在每两次查看/浏览/搜索操作后立即将关键发现保存到文本文件中**。操作1研究Python Web框架 → 记录到findings.md 操作2查看Flask文档 → 记录到findings.md 操作3查看Django文档 → 现在必须更新findings.md这个规则确保视觉和多模态信息不会丢失因为截图、PDF内容和浏览器结果不会持久化。 ## 高级功能多模式运行策略 ### 1. 传统模式Legacy Mode 默认模式适合大多数交互式会话。在每个工具调用前重新读取计划文件确保AI始终关注目标。 ### 2. 自主模式Autonomous Mode 针对长时间运行任务优化减少重复读取的开销 bash ./scripts/init-session.sh --autonomous3. 门控模式Gated Mode添加完成验证门确保所有阶段完成才结束会话./scripts/init-session.sh --gated4. 多项目并行规划对于多个不相关任务使用隔离的计划目录# 创建独立的规划目录 ./scripts/init-session.sh backend-refactor ./scripts/init-session.sh production-incident # 设置活动规划 ./scripts/set-active-plan.sh 2026-01-10-backend-refactor 最佳实践专业开发者的使用技巧1. 错误处理的3次尝试协议尝试1诊断并修复 尝试2采用不同方法 尝试3重新思考整个方法每个错误都必须记录在task_plan.md的错误遇到部分包含错误类型、尝试次数和解决方案。2. 决策矩阵管理在findings.md中使用表格记录所有技术决策决策理由替代方案使用SQLite而非JSON关系查询需求JSON文件选择Flask而非Django项目规模小Django3. 会话恢复策略当上下文填满需要/clear时planning-with-files会自动恢复会话检查IDE的会话存储查找规划文件的最后更新时间提取可能丢失的上下文对话显示恢复报告4. 模板系统定制项目提供了多个模板文件你可以根据需求定制templates/task_plan_autonomous.md- 自主运行模板templates/analytics_task_plan.md- 数据分析任务模板templates/loop.md- 循环任务模板 实际案例构建完整的Web应用案例开发一个博客平台任务规划文件task_plan.md## 目标 创建一个支持Markdown编辑、用户认证和评论系统的博客平台。 ## 阶段 ### 阶段1需求分析 - [x] 确定核心功能 ✓ - [x] 选择技术栈 ✓ - **状态:** complete ### 阶段2数据库设计 - [x] 设计用户表 ✓ - [x] 设计文章表 ✓ - **状态:** complete ### 阶段3后端API开发 - [ ] 实现用户认证端点 - [ ] 创建文章CRUD接口 - **状态:** in_progress研究发现文件findings.md## 研究结果 ### 技术栈选择 - Flask SQLAlchemy轻量级适合中小项目 - JWT认证无状态适合REST API - SQLite开发PostgreSQL生产 ### 关键决策 | 决策 | 理由 | |------|------| | 使用JWT而非Session | 更好的无状态API支持 | | Markdown存储为HTML | 减少渲染开销 |进度日志文件progress.md## 会话记录2026-06-23 ### 阶段3后端API开发 - 创建了用户模型User(id, username, email, password_hash) - 实现了注册端点POST /api/auth/register - 测试通过用户注册成功 - 错误修复修复了密码哈希问题尝试2️ 安全与验证防篡改机制planning-with-files v3引入了强大的安全特性1. 哈希认证Attestation# 对计划文件进行哈希认证 ./scripts/attest-plan.sh认证后任何对task_plan.md的未授权修改都会被钩子拒绝注入确保计划完整性。2. 接受检查Acceptance Check在门控模式中可以定义自动验证命令### 阶段4测试与验证 - **接受检查:** python -m pytest tests/ -q【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running agentic tasks. Crash-proof markdown plans that survive context loss and /clear, plus a deterministic completion gate and multi-agent shared state on disk. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60 agents via the SKILL.md standard.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考