Idea Plan

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

这是一个标准的 VIBE Skill，可以直接作为 submodule 引入到项目中。

目录结构

idea-plan/
├── SKILL.md              # Skill 入口（Agent 行为指南）
├── example/              # .plan 示例
│   └── Diffusion.plan/
├── stage/                # 操作阶段指南
│   ├── create.md
│   ├── read.md
│   ├── update.md
│   └── iterate.md
├── mcp/                  # MCP 工具实现
│   └── src/idea_plan_mcp/
│       ├── server.py
│       └── utils.py
└── docs/                 # 说明文档
    ├── architecture.md
    └── usage.md

核心概念

.plan 文件体系

<idea-name>.plan/
├── INDEX.md              # 任务总索引
├── overview/
│   ├── abstract.md       # What: 摘要、动机、研究问题
│   └── architecture.md   # How: 全局架构、模块分解
├── tasks/                # Milestone → Keypoint 层级
│   └── 1/
│       ├── 1.md          # Milestone 描述
│       ├── state.md      # 状态追踪
│       └── 1.1/          # Keypoint
└── log/                  # 对话与问题记录（可选）

任务层级

层级	定位	对应论文
Milestone	阶段性里程碑	章节
Keypoint	原子任务，可并行	小节/实验

状态流转

⬜️ 未开始 → ⏳ 进行中 → ✅ 已完成 → 🔍 人工审核

使用方式

1. MCP 工具（程序化调用）

在 Claude/Copilot 等 AI 工具中配置 idea-plan-mcp，即可使用以下工具：

工具	功能
plan_create	创建 .plan 骨架
plan_list	任务树概览
plan_read	分级读取内容
plan_update_state	更新状态
plan_update_task	增删改任务

2. Skill 指南（Agent 行为规范）

AI Agent 根据 idea-plan-skill/SKILL.md 中的指南，在科研 workflow 中自动调用 MCP 工具。

设计理念

1. Paper-first：结构对齐论文写作流程
2. 人机共读：Markdown 格式，人可阅读，Agent 可解析
3. 分布式状态：每个任务独立 state.md，支持跨对话追踪

快速开始

详见 docs/usage.md

License

MIT