---
name: idea-plan
description: 科研idea规划与跨对话追踪skill。将科研需求转化为 Milestone-Keypoint 两级任务体系，以 .plan 文件结构支持跨对话状态追踪。触发场景：用户需要规划实施路径、追踪多阶段进度、跨对话继续科研项目、调整现有计划。
---

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

```yaml
---
state: ⬜️  # ⬜️ | ⏳ | ✅ | 🔍
---
# 摘要
<!-- 跨对话时供Agent快速了解当前进展 -->

# 问题与阻塞
<!-- 实施中遇到的问题，便于下次对话继续 -->
```

## 操作流程

| 阶段 | 触发条件 | 指南 |
|------|----------|------|
| **创建** | 已明确需求，无.plan | [stage/create.md](stage/create.md) |
| **读取** | 存在.plan，需恢复上下文 | [stage/read.md](stage/read.md) |
| **更新** | 完成任务，需同步状态 | [stage/update.md](stage/update.md) |
| **迭代** | 需调整idea或技术路线 | [stage/iterate.md](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 |

## 设计理念

1. **Paper-first**：结构对齐论文(Introduction→Method)，支持LaTeX/Mermaid
2. **人机共读**：面向科研人员理解，Agent可解析执行
3. **分布式状态**：每个任务独立state.md，支持并行与跨对话追踪