Skip to content

Lin-zhijie/grant-master

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Grant-Master

把中文项目申请书从一次性写作,拆成可审计、可恢复、可迭代的研究与写作流水线。

English | 中文

License: MIT Codex Plugin Claude Code Plugin

Why

申请书不是一个 prompt 能稳定解决的问题。

它需要先理解课题,再做文献调研、论文精读、证据综合、方案收敛、大纲规划、逐段写作、全局审阅,最后再输出 Word 文档。直接让模型“写一份申请书”,很容易得到看起来完整但证据链薄、结构漂移、引用不可追踪的草稿。

Grant-Master 做的是约束这条链路:每一步都有明确输入、输出、质量门禁和磁盘状态。上下文断了可以继续,方向偏了可以回滚,写作前能先看到 evidence ledger、scheme blueprint、writing units,而不是等最终草稿才发现问题。

适合:

  • 中文项目申请书初稿:NSFC、校内基金、科研计划书等长文档;
  • 新方向调研:从 topic.md 生成搜索计划、论文精读报告和领域综合理解;
  • 申请书架构设计:把方案拆成章节预算、writing units、图表计划和引用计划。

不适合:

  • 无人工审校直接提交;
  • 自动生成真实个人基础、团队条件、预算或政策承诺;
  • 绕过付费墙下载论文全文。

See It

仓库内置一个完整 demo,展示从课题到 Word 初稿的运行结果。PDF 原文不随仓库分发,demo 展示的是流程产物和最终草稿。

如果要做成 Kami 那种预览墙,建议补 3 张截图:current_view.md 片段、outline_blueprint.yaml/writing_units.yaml 片段、最终 proposal.docx 首屏。

Usage

Install

Codex

推荐让 Codex 自己安装。新开一个 Codex 对话,把下面这句话发给 Codex:

请从 https://github.com/Lin-zhijie/grant-master 安装 Grant-Master Codex plugin。请 clone 仓库后运行 scripts/install-codex.sh(Windows 则运行 scripts/install-codex.ps1),完成后告诉我是否安装成功。

如果你已经手动 clone 了仓库,也可以在仓库根目录直接运行:

bash scripts/install-codex.sh

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File scripts/install-codex.ps1

详细安装逻辑和排障见 Codex Desktop 安装说明

安装后在任意申请书项目目录测试:

/grant-master:auto 状态

Claude Code CLI

下载或克隆项目:

git clone <repo-url> grant-master

使用以下指令创建一个空的 plugin,路径在 ~/.claude/skills/grant-master:

claude plugin init grant-master

之后,把我们项目中的所有文件迁移到新创建的 plugin 中即可。

依赖

基础依赖:

sudo apt install pandoc curl

可选依赖:

pip install weasyprint python-docx

浏览器型学术搜索,如 Google Scholar / CNKI,需要 Node.js 22+、Chrome remote debugging 和本地 CDP Proxy:

bash scripts/academic-search/check-deps.sh

Start

在你的申请书项目目录中创建 topic.md

# 面向高性能分布式训练的网络资源智能调度方法研究

请围绕以下方向生成中文项目申请书:

- 项目类型:青年项目 / 面上项目 / 校内基金
- 研究对象:高性能网络、RDMA、分布式训练
- 希望解决的问题:多租户训练场景下的网络性能隔离与资源调度
- 预期成果:算法、系统原型、实验验证

可选补充:

requirements.md          # 申报要求、模板栏目、页数/字数限制、评审偏好
applicant_profile.md     # 申请人基础、论文、项目、平台、团队条件
references/Template.docx # 官方模板或希望沿用的 docx 样式

启动协作模式:

/grant-master:auto

启动自动模式:

/grant-master:auto --auto

第一次使用建议协作模式。关键节点会停下来让你确认:是否继续调研、是否进入方案收敛、是否开始写作、是否输出 docx。

Workflow

01_topic
  ↓
02_literature_plan → 03_academic_search → 04_paper_digest → 05_synthesis
  ↑                                                              │
  └──────── 调研循环 ────────────────────────────────────────────┘
                                                                  ↓
06_helm
  ↓
07_outline
  ↓
08_section_write  ←──── 10_review 发现 P0 问题后回写
  ↓
09_assemble
  ↓
10_review
  ↓
11_output

常用命令:

/grant-master:auto              # 从当前状态推进
/grant-master:auto --auto       # 自动推进直到完成或阻塞
/grant-master:auto 状态         # 查看进度
/grant-master:auto 继续         # 从中断处续跑
/grant-master:auto 继续调研     # 强制进入下一轮调研
/grant-master:auto 进入方案     # 从 synthesis 进入 helm
/grant-master:auto 审阅         # 触发 assemble + review
/grant-master:auto 输出         # 审阅通过后生成 docx

也可以手动调用单阶段:

/grant-master:01-topic
/grant-master:02-literature-plan
/grant-master:03-academic-search
/grant-master:04-paper-digest
/grant-master:05-synthesis
/grant-master:06-helm
/grant-master:07-outline
/grant-master:08-section-write
/grant-master:09-assemble
/grant-master:10-review
/grant-master:11-output

Output

Grant-Master 在你执行命令的项目目录中写入 workflow/

workflow/
├── proposal_state.yaml
├── 03_academic_search/     # 搜索报告、候选论文、下载状态
├── 04_paper_digest/        # 精读报告、paper index
├── 05_synthesis/           # current view、evidence ledger
├── 06_helm/                # scheme blueprint、decision log
├── 07_outline/             # outline、volume budget、writing units
├── 08_section_write/       # unit 正文
├── 09_assemble/            # proposal_draft.md / pdf
├── 10_review/              # P0/P1/P2 审阅结果
└── 11_output/              # proposal.docx

auto 只在验证阶段产物存在且非空后更新状态。完整契约见 docs/workflow-contract.md

Safety

Grant-Master 只允许自动下载合法开放全文,包括 arXiv、PubMed Central、Semantic Scholar openAccessPdf、OpenAlex、Unpaywall、出版商明确开放的 PDF,以及用户手动放入 papers/inbox/ 的本地文件。

对需要机构权限或无公开开放全文的论文,系统只记录 DOI、论文链接、开放获取状态和合法获取建议,不自动下载,也不搜索、访问、推荐或使用 Sci-Hub、LibGen 等绕过付费墙的来源。

浏览器型搜索会通过 CDP Proxy 控制本机 Chrome,可能继承浏览器登录态。不要暴露 127.0.0.1 本地代理端口,不要在不可信环境运行浏览器自动化,也不要提交 cookie、session、截图、日志、未授权 PDF 或其他敏感文件。

更完整的合规规则见 docs/compliance.mdreferences/academic-search/search-protocol.md

Development

轻量检查:

git diff --check
bash -n scripts/academic-search/check-deps.sh
bash -n scripts/academic-search/self-test.sh
node --check scripts/academic-search/cdp-proxy.mjs
node --check scripts/academic-search/oa-pdf-download.mjs
node --test tests/**/*.test.mjs

学术搜索模块参考并改造自 ustc-ai4science/academic-search。第三方声明见 docs/third-party-notices.md

License

MIT License. See LICENSE.

About

中文项目申请书全流程写作工具链 Grant-Master,支持课题理解、文献调研、论文精读、方案收敛、大纲规划、正文写作、审阅与 docx 输出。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors