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