Idea Plan

面向科研人员的分布式任务规划系统，对齐论文写作的思维模式。

.plan 文件体系

<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 模板

---
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，支持并行与跨对话追踪