Idea Plan
面向科研人员的分布式任务规划系统,对齐论文写作的思维模式。
.plan 文件体系
code
<idea-name>.plan/
├── INDEX.md # 任务总索引(状态自动同步自 state.md)
├── overview/
│ ├── abstract.md # What: 摘要、动机、研究问题、主要方法
│ └── architecture.md # How: 全局架构、主要管线、模块分解
├── tasks/ # Milestone → Keypoint 层级
│ ├── 1/
│ │ ├── 1.md # Milestone 总述
│ │ ├── state.md # 状态 + 跨对话摘要
│ │ ├── 1.1/
│ │ │ ├── 1.1.md # Keypoint 细述
│ │ │ └── state.md
│ │ └── ...
│ └── ...
└── log/ # 可选
├── chat/ # 用户显式保存的AI对话
└── record/ # Agent汇总的问题/发现
任务层级
| 层级 | 定位 | 必备字段 |
|---|---|---|
| Milestone | 阶段性里程碑,对应Paper章节 | 说明 |
| Keypoint | 原子任务,可并行执行 | 目标、技术要点、产物 |
Agent可按需添加少量辅助字段(如"前置依赖"、"验收标准"),保持精炼即可。
状态:⬜️未开始 → ⏳进行中 → ✅已完成 → 🔍人工审核
state.md 模板
yaml
--- state: ⬜️ # ⬜️ | ⏳ | ✅ | 🔍 --- # 摘要 <!-- 跨对话时供Agent快速了解当前进展 --> # 问题与阻塞 <!-- 实施中遇到的问题,便于下次对话继续 -->
操作流程
| 阶段 | 触发条件 | 指南 |
|---|---|---|
| 创建 | 已明确需求,无.plan | stage/create.md |
| 读取 | 存在.plan,需恢复上下文 | stage/read.md |
| 更新 | 完成任务,需同步状态 | stage/update.md |
| 迭代 | 需调整idea或技术路线 | stage/iterate.md |
MCP 工具
配套 idea-plan-mcp 提供以下工具:
| 工具 | 功能 |
|---|---|
plan_create | 创建.plan骨架(默认1×1最小结构) |
plan_list | 任务树概览 |
plan_read | 分级读取(scope: overview/index/milestone:X/keypoint:X.Y/current) |
plan_update_state | 更新状态+摘要,自动同步INDEX.md |
plan_update_task | 增删改任务(add/delete/rename Milestone或Keypoint) |
plan_sync_index | 手动同步state.md→INDEX.md |
设计理念
- •Paper-first:结构对齐论文(Introduction→Method),支持LaTeX/Mermaid
- •人机共读:面向科研人员理解,Agent可解析执行
- •分布式状态:每个任务独立state.md,支持并行与跨对话追踪