Imported from jimschenchen/Academic-KB-Skills (project-manager/SKILL.md). Install upstream with npx skills add jimschenchen/Academic-KB-Skills --skill project-manager. Copyright stays with the author.

Project Manager Skill

管理 Obsidian vault 中的学术项目全生命周期：项目创建、Funding 关联、状态跟踪、进度报告、结构同步与健康检查。

Vault 结构概览

vault-root/
├── projects/
│   ├── Projects.base                    # 项目数据库视图
│   └── Project-{Name}/
│       ├── Project-{Name}.md            # 主项目 note
│       └── {支撑文档}.md               # 执行计划、实现指南等
├── fundings/
│   ├── Fundings.base                    # Funding 数据库视图
│   ├── Funding-Project Mapping.md       # 核心映射索引
│   └── {Acronym} — {Full Name}/
│       ├── {Acronym} — {Full Name}.md   # 主 funding note
│       └── {原始文件}.pdf              # 提交的 PDF 等
├── ideas/
│   ├── Ideas MOC.md                     # 灵感索引
│   ├── templates/Idea Template.md
│   ├── {ProjectShortName}/             # 按项目分类
│   └── unsorted/                       # 未分类
├── Task Dashboard.md                    # obsidian-tasks 查询面板
└── Task Kanban.md                       # Kanban 看板

参考文件

以下 reference 文件包含详细的 schema 定义和模板。在执行具体 Procedure 前，先 Read 对应的 reference 文件。

Procedure 0: Create Project — 创建新项目

触发：用户想创建新项目、新 research 方向、或将 idea 升级为项目。

步骤

1. 收集信息（向用户确认）：

   • 项目名称（英文 CamelCase + 中文副标题）
   • project_type（从 6 种类型中选择）
   • 初始 status（通常 planning）
   • 关联的 funding（可选，可后续用 Procedure 2 添加）
   • 简要描述（1-2 段）
   • 初始目标列表

2. Read reference 文件：

   • references/project-frontmatter.md — 确认 schema
   • references/project-note-template.md — 获取模板

3. 创建文件结构：

   • 创建文件夹：projects/Project-{Name}/
   • 创建主 note：projects/Project-{Name}/Project-{Name}.md
   • 按模板填充 frontmatter 和所有标准 section
   • date 使用当天日期

4. 更新关联（如有 funding）：

   • 在 project note 的 fundings 数组中添加 wikilink
   • 在对应 funding note 的 Tasks 表格中添加行
   • 运行 Procedure 5（Sync Mapping）更新 Funding-Project Mapping

5. 更新 Ideas MOC：

   • 在 ideas/Ideas MOC.md 的「按项目分类」下添加该项目的 section
   • 如果是从 idea 升级的，更新原 idea 的 status 为 archived

6. 更新 Task Kanban：

   • 在 Task Kanban.md 中添加新列（项目名称）

7. 确认输出：向用户报告创建的文件和更新的关联。

命名规范

• 文件夹和文件名：Project-{CamelCaseName}
• title 格式："Project: {Name} — {中文副标题}"
• aliases：至少包含简称（不含 Project- 前缀）

Procedure 1: Create Funding — 创建新 Funding/Proposal

触发：用户想记录新的资助申请、竞赛或未来项目构想。

步骤

1. 收集信息（向用户确认）：

   • Acronym + Full Name（中英文）
   • type（funding / competition / future-project）
   • funding_source、pi、co_pi
   • amount、duration
   • my_role（implementation-lead / collaborator / contributor）
   • deadline（如有）
   • 关联的 projects（可选）

2. Read reference 文件：

   • references/funding-frontmatter.md
   • references/funding-note-template.md

3. 创建文件结构：

   • 创建文件夹：fundings/{Acronym} — {Full Name}/
   • 创建主 note：fundings/{Acronym} — {Full Name}/{Acronym} — {Full Name}.md
   • 按模板填充所有 section
   • 如有关联 projects，填写 Tasks 表格

4. 更新关联 projects（如有）：

   • 在每个关联 project 的 frontmatter fundings 数组中添加 wikilink
   • 在 project note 的「Funding 任务分解」section 添加对应 h3 小节

5. 运行 Procedure 5（Sync Mapping）更新全局映射。

6. 确认输出。

命名规范

• 文件夹名：{Acronym} — {Full Name}（em-dash 分隔）
• aliases：缩写形式，如 CRF2026

Procedure 2: Link — 关联实体

触发：用户想把 project 关联到 funding、idea、paper 或其他 project。

支持的关联类型

步骤

1. 确认关联：识别或询问用户要关联的两个实体。

2. 执行关联（根据类型）：

   Project ↔ Funding：

   • 在 project frontmatter 的 fundings 数组中添加 funding wikilink
   • 在 project note 的「Funding 任务分解」添加 h3 小节（向用户确认 task 描述）
   • 在 funding note 的 Tasks 表格中添加行
   • 运行 Procedure 5 同步 Mapping

   Project ↔ Idea：

   • 更新 idea note frontmatter 的 project 字段
   • 如果 idea 在 ideas/unsorted/，移动到 ideas/{ProjectShortName}/
   • 更新 Ideas MOC 中的分类

   Project ↔ Paper：

   • 在 project note 的「Related Notes」section 添加 [[papers/{Title}/{Title}]]
   • 如果 paper note 存在，在其 frontmatter tags 中添加项目相关 tag

   Project ↔ Project：

   • 确认依赖方向（上游/下游/相关）
   • 在双方的「依赖关系」section 中添加 wikilink 和说明

3. 确认输出：列出所有修改的文件。

Procedure 3: Update Status — 更新状态

触发：用户想改变项目或 funding 的状态。

步骤

1. 确认变更：

   • 目标实体（project 或 funding）
   • 新 status 值
   • 变更原因（可选，记录在 note 中）

2. 更新 frontmatter：

   • 修改 status 字段
   • 如果是 project，同步更新 tags 中的状态 tag（active ↔ planning ↔ completed ↔ paused）

3. 联动检查（仅当状态变为 completed 或 paused）：

   • 检查该 project 的下游依赖项目，提醒用户
   • 检查未完成的 tasks（- [ ]），提醒用户
   • 如果是 funding 变为 rejected，提醒用户检查关联 projects 是否需要调整

4. 记录变更：在 note 的「当前进度」或顶部添加一行变更记录：

   > [!note] {YYYY-MM-DD} 状态变更：{旧状态} → {新状态}
   > {原因}

5. 确认输出。

Procedure 4: Report — 生成进度报告

触发：用户想了解项目进度、funding 覆盖情况或全局概览。

报告类型

4a: 单项目报告

1. Read 目标 project note。
2. 统计：
   • 总 tasks 数、已完成数、完成率
   • 关联 funding 数量
   • 交付物状态分布
3. 输出格式：

## 📊 Project-{Name} 进度报告 ({date})

**状态**: {status_icon}
**类型**: {type_label}
**关联 Funding**: {count} 个

### 任务进度
- 总任务: {total} | 已完成: {done} | 进行中: {total - done}
- 完成率: {percentage}%

### 交付物状态
| 交付物 | 来源 | 状态 |
|--------|------|------|
| ... | ... | ... |

### 未完成的关键任务
- [ ] ...

### 依赖状态
- 上游: {列表及其状态}
- 下游: {列表及其状态}

4b: Funding 报告

1. Read 目标 funding note。
2. 统计关联 projects 的进度。
3. 列出 tasks 和对应 project 的完成情况。

4c: 全局概览

1. Glob projects/Project-*/Project-*.md 获取所有 project notes。
2. Glob fundings/*/[!F]*.md 获取所有 funding notes（排除 Funding-Project Mapping）。
3. 汇总：
   • 各状态的项目数量
   • 各类型的项目分布
   • 有/无 funding 的项目
   • 临近 deadline 的 funding
   • 整体 task 完成率

Procedure 5: Sync Mapping — 同步 Funding-Project 映射

触发：用户要求同步映射，或在 Procedure 0/1/2 中自动触发。

步骤

1. 扫描所有 project notes：

   • Glob projects/Project-*/Project-*.md
   • 从每个 note 提取 frontmatter 的 fundings 数组
   • 构建 project → fundings 反向索引

2. 扫描所有 funding notes：

   • Glob fundings/*/[!F]*.md
   • 从每个 note 提取 frontmatter（title, aliases, pi, amount 等）
   • 读取 Tasks 表格获取 project 关联和 task 描述

3. 重新生成 Funding-Project Mapping.md：

   • 保持现有结构不变
   • Fundings section：每个 funding 一个 h3，包含 blockquote 元信息 + project 列表
   • 反向索引 section：Project → Fundings 的表格
   • 格式参考现有文件：

     ### {Funding Title}
     
     > {funding_source} | PI: {pi} | {amount}
     
     - [[projects/Project-{Name}/Project-{Name}|{Alias}]] — {Task描述}

4. 差异检查：

   • 对比更新前后的 Mapping 内容
   • 报告新增/删除/修改的映射关系

5. 确认输出。

重要规则

• Mapping 的 Fundings section 按 funding note 的 aliases 字母排序
• 反向索引按 project 名称排序
• wikilink 格式：[[projects/Project-{Name}/Project-{Name}|{ShortAlias}]]
• funding 的 blockquote 包含：来源 | PI | 金额（如有）

Procedure 6: Lint — 结构健康检查

触发：用户想检查 vault 的项目管理结构是否健康。

检查项

6a: Frontmatter 完整性

• 所有 project notes 是否包含必填字段（tags 含 project、status、project_name、project_type、date）
• 所有 funding notes 是否包含必填字段（tags 含 proposal、status、type、my_role、date）
• idea notes 是否包含 tags: [idea]、status、date

6b: 命名规范

• Project 文件夹是否为 Project-{CamelCase} 格式
• Project .md 文件名是否与文件夹名一致
• 特殊项目：某些 project 文件夹（如 Project-PQE、Project-Awesome-AI-for-Earth-Science）可能不含标准 project note，而是包含其他类型文档（考试材料、GitHub repo docs）。这些应标记为 ⚠️ 警告而非 ❌ 错误
• Funding 文件夹是否使用 em-dash（—）分隔
• Funding .md 文件名是否与文件夹名一致
• 排除非主文件：funding 文件夹中的会议纪要、PDF 等辅助文件不做 schema 检查，只检查与文件夹同名的 .md 主文件

6c: 关联一致性

• Project frontmatter 的 fundings 中每个 wikilink 是否指向存在的 funding note
• Funding note Tasks 表格中的 project wikilink 是否指向存在的 project note
• 双向检查：如果 project A 声称关联 funding X，funding X 的 Tasks 表格是否也包含 project A
• Ideas MOC 中列出的 idea 文件是否存在

6d: Mapping 同步状态

• Funding-Project Mapping.md 的内容是否与各 note 的 frontmatter 一致
• 如不一致，列出差异并建议运行 Procedure 5

6e: 任务状态

• 是否有 status: completed 的项目仍有未完成的 tasks
• 是否有 status: in-progress 的项目没有任何 tasks
• Task Kanban 中的列是否覆盖所有活跃项目

6f: 孤立实体

• 没有关联任何 funding 的 project（可能是正常的，但需提醒）
• 没有关联任何 project 的 funding（应该报告）
• ideas/unsorted/ 中的 ideas 是否需要分类

输出格式

## 🔍 Vault 健康检查 ({date})

### ✅ 通过 ({count})
- ...

### ⚠️ 警告 ({count})
- ...

### ❌ 错误 ({count})
- ...

### 📋 建议操作
1. ...
2. ...

分为三个级别：

• ✅ 通过：符合规范
• ⚠️ 警告：不影响功能但建议修复（如孤立项目、缺少 aliases）
• ❌ 错误：需要修复（断链、schema 不完整、双向不一致）

Procedure 7: Capture Idea — 灵感速记

触发：用户随口提到一个想法、灵感、直觉，不论是否明确提到项目名。这是最轻量的操作——用户说想法，skill 自动归档。

核心原则

• 零摩擦：不问多余问题，不套完整模板，速度优先
• 智能归类：根据想法内容自动识别关联 project
• 最小记录：只记核心想法（1-3 句），日后可展开

步骤

1. 解析用户输入：

   • 提取核心想法（用户说了什么）
   • 推断关联 project：
     • 如果用户明确提到项目名 → 直接使用
     • 如果用户提到领域关键词（如 "灾害数据库"、"早期预警"、"harness"）→ 匹配最相关 project
     • 如果无法判断 → 放入 ideas/unsorted/，不打断用户去问

2. 生成 idea title：

   • 从用户的话中提取简洁英文标题（3-8 个词）
   • 标题应反映核心想法，不是项目名
   • 例："Agent Self-Reflection for Parameter Tuning"

3. 创建轻量 idea note：

   • Read references/idea-quick-template.md 获取轻量模板
   • 文件位置：
     • 已归类：ideas/{ProjectShortName}/{Title}.md
     • 未归类：ideas/unsorted/{Title}.md
   • 用轻量模板，只填核心内容

4. 更新 Ideas MOC：

   • 在 ideas/Ideas MOC.md 对应项目 section 下添加 wikilink
   • 在「最近添加」section 顶部添加一行（含日期）
   • 如果放入 unsorted，添加到「未分类」section

5. 简短确认：

   • 一句话告诉用户：想法已记录到 {路径}，归类到 {ProjectName}
   • 不要长篇大论解释做了什么

Project 匹配关键词参考

在无法确定时，参考以下关键词映射：

注意：这张表只是辅助。优先根据用户的实际语义判断，不要死板匹配关键词。如果想法跨多个项目，选最核心的那个，或放 unsorted。

连续捕捉模式

如果用户在短时间内连续抛出多个想法：

• 逐个创建 note，不要合并
• 每个想法独立归类
• 批量确认：最后一起报告所有记录的想法

通用规则

Wikilink 格式

• Project 引用：[[projects/Project-{Name}/Project-{Name}|{ShortAlias}]]
• Funding 引用：[[{FolderName}|{Acronym}]]
• Ideas 引用：[[ideas/{Folder}/{Title}]]
• Papers 引用：[[papers/{Title}/{Title}]]

日期格式

• 所有日期使用 YYYY-MM-DD（ISO 8601）
• 用户说"周四"时，转换为绝对日期

语言规范

• Frontmatter 字段名：全英文
• 内容正文：中英混合（与 vault 现有风格一致）
• Section 标题：中文（带括号英文），如 ## 项目概述、## 目标 (Goals)

文件操作安全

• 修改文件前，先 Read 确认当前内容
• 编辑 frontmatter 时使用精确的 string replacement，避免误改正文
• 创建新文件时检查是否已存在同名文件/文件夹
• 涉及多个文件修改时，逐一确认后再执行

与其他 Skill 的协作

• 当用户要求关联 paper 时，paper note 应由 academic-kb skill 管理
• 本 skill 只在 project note 的 Related Notes 中添加 wikilink
• 如果用户想深入某个 project 的技术方案，建议使用 brainstorming skill