mcpField
I
intake-project

intake-project

github.com/aperivue生产力353113 次安装1 天前更新
代码仓库

关于 intake-project

intake-project 是用于整理研究项目资料并判断项目阶段的技能，面向需要接手、清理或移交项目的研究团队。它检查现有文件、归类项目并提出缺失输入，创建文件前会先请求确认。

主要功能

  1. 01扫描项目文件与目录
  2. 02识别项目类型和当前阶段
  3. 03检查缺失输入与依赖
  4. 04规范项目摘要与文件结构
  5. 05创建文件前确认分类

适用场景

  1. 01接手已有研究项目时盘点资料
  2. 02整理偏离规范目录的项目文件
  3. 03移交前梳理项目阶段与待办

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aperivue/medsci-skills --skill intake-project

安装后在 Claude Code 中输入/intake-project确认已加载。

附带文件references/memory_templates.mdskill.yml

详细介绍

Intake-Project Skill

标准手稿文件夹结构

/manage-project init 会为新项目搭建框架；其脚本是该目录结构的权威来源，包括 QC 技能写入文件的 qc/ 文件夹。对于从未通过脚手架搭建的现有项目，请使用下方的布局重新整理，将每项材料映射到相应位置，或映射到 init 脚手架或其他技能已写入文件的文件夹中。

{project_root}/
├── HANDOFF.md                         # session handoff entry point
├── README.md                          # project overview
├── data/                              # raw data (NEVER edit; read-only)
├── analysis/                          # reproducible scripts (00_* → 04_*)
├── output/                            # analysis outputs: CSVs, PNGs, intermediates
├── qc/                                # QC reports the skills write (self-review, checklists, audits)
├── irb/                               # IRB/ethics docs
├── proposal/                          # original protocol / approved proposal
├── reviews/                           # external correspondence
├── manuscript/                        # SOURCE manuscript + drafting
│   ├── manuscript_v{N}.{md,docx,pdf}  # current canonical working version (top level)
│   ├── build_unified_docx.py          # or pandoc wrapper
│   ├── archive/                       # ALL prior versions v1 .. v{N-1}
│   ├── reviews/                       # review notes (QC reports go in qc/ at the root)
│   ├── figures/                       # figure scripts + rendered PNG/PDF
│   └── tables/                        # table scripts + rendered docx
└── submission/                        # per-journal packages
    └── {journal-slug}/                # e.g., chest/, kjr/
        ├── CHECKLIST.md
        ├── cover_letter.{md,docx,pdf}
        ├── title_page.docx            # separated for double-anonymized
        ├── manuscript_anonymized.{docx,pdf}
        ├── supplement.{docx,pdf}
        ├── strobe_checklist.md        # or PRISMA / CONSORT
        ├── circulation_email.md
        └── figures/                   # submission-ready DPI copies
规则
  • manuscript/ = 源文件；submission/{journal}/ = 派生材料。 从 manuscript/manuscript_v{N}.md 重新生成投稿文件；切勿直接编辑匿名版或标题页。
  • 只保留一个规范工作版本，位于 manuscript/manuscript_v{N}.{md,docx,pdf}。版本号更新后，立即将旧版本移至 manuscript/archive/。
  • 项目根目录不得放置散落文件。 仅允许存在 HANDOFF.md、README.md、项目记忆文件（Phase 3）、/manage-project init 写入的契约文件（SSOT.yaml 或 project.yaml、project_state.json、artifact_manifest.json）以及文件夹条目。
  • QC 材料（自查、报告清单、交叉引用和参考文献审计）放在项目根目录的 qc/ 中，由生成这些材料的技能写入，而不是放在 manuscript 顶层。
  • 拒稿或转投时： cp -r submission/{old} submission/{new}，然后重写投稿附信并重新排版。
  • 双盲期刊（Chest、AJRCCM）：标题页和匿名手稿必须作为单独文件放在 submission/{journal}/ 下。
  • 保留现有项目标签和文件名所使用的语言。
何时应用
  • 项目接收时：通过 /manage-project init 搭建框架，除非用户只想快速评估。
  • 首次准备投稿时：创建 submission/{journal}/ 并填入文件。
  • 项目中期清理时：当 manuscript/ 中有超过 3 个带版本号的文件，或 QC 文档位于顶层时，重新整理。
  • 会话交接前：如果结构偏离规范，则重新整理。

工作流

Phase 1：了解上下文
  1. 查看顶层文件夹名称和关键文件。
  2. 检测类似手稿的文件、表格、图、方案和分析输出。
  3. 提取：
    • 项目标题或暂定标题
    • 研究问题
    • 数据集或队列线索
    • 合作者或机构
    • 投稿渠道或期刊线索
Phase 2：确定项目类别和阶段

确定：

  • 项目类型：original | review | meta-analysis | case report | technical note | grant | peer review | challenge | career-doc
  • 主要领域：radiology | medical AI | multimodal LLM | intervention | survival/prognostic | diagnostic accuracy | workflow
  • 目标输出：paper | abstract | grant | review | rebuttal | CV
  • 可能的目标期刊或投稿渠道——仅当文件中提及时填写
  • 当前阶段（选择一个）：idea | data assembly | analysis planning | analysis in progress | drafting | revision | submission prep | archived/unclear

如果文件夹中包含多项研究，请明确说明，不要将它们合并为一项。

关卡： 向用户展示分类结果（项目类型、阶段、目标输出）。 创建任何文件前都要先确认——分类错误会导致脚手架搭建和技能路由出错。

Phase 3：指出缺失的输入

检查阻塞依赖项和常见缺漏：

  • 未明确研究问题
  • 未确定目标期刊
  • 没有分析计划
  • 没有变量字典
  • 没有主张与结果对应表
  • 修订稿没有审稿记录

如果有缺漏，可提出或创建轻量级锚点文件——PROJECT.md、STATUS.md、CLAIMS.md、 DATA_DICTIONARY.md、ANALYSIS_PLAN.md、REVIEW_LOG.md——仅创建项目类型所需的文件。 创建 PROJECT.md 或 STATUS.md 时，请阅读 ${CLAUDE_SKILL_DIR}/references/memory_templates.md。

Phase 4：生成规范化摘要

输出以下结构：

## Project Intake Summary
Project: ...
Type: ...
Current stage: ...
Likely target: ...

### What exists
- ...

### What is missing
- ...

### Risks / ambiguities
- ...

### Recommended next actions (3-5, in dependency order)
1. ...
2. ...
3. ...

移交规则

完成接收后：

  • 如果文献依据薄弱，则转交给 search-lit
  • 如果已有研究问题，但设计逻辑不清晰，则转交给 design-study
  • 如果需要搭建文件夹结构，则转交给 manage-project
  • 只有在项目阶段明确为 drafting 后，才转交给 write-paper

评论

支持 Markdown