Awesome-omni-skill idea-plan

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

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/idea-plan" ~/.claude/skills/diegosouzapw-awesome-omni-skill-idea-plan && rm -rf "$T"
manifest: skills/tools/idea-plan/SKILL.md
source content

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快速了解当前进展 -->

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

操作流程

阶段触发条件指南
创建已明确需求,无.planstage/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

设计理念

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