01 · 研究
STAR
Systematic Toolchain for AI Research
推进一个研究项目：从想法出发，经可复现实验，产出可直接用于论文的证据。
STORY
A STAR takes the STAGE to tell a STORY
作为 STAR 与 STAGE 配套的硕士/博士学位论文工具——STORY 把研究生阶段的研究、相关的发表论文和带指纹的证据组织成一部经得起答辩、可直接归档的学位论文： 每个数字都能追溯到证据文件，或显式标记为缺失；复用已发表内容时保留作者贡献说明； 委员会意见和学位要求都记录在案。
16工作流 Skill
7种 AI Agent
2种语言 · EN 中文
MIT开源许可
STAR 项目家族
一条研究生涯链路。
三套各司其职的工具链。
三者都可以独立使用；连起来时，上游产物以带指纹的只读证据流向下游。
为什么选择 STORY
多年研究积累。
一部经得起答辩的论文。
当证据散落在旧仓库、数字留在聊天记录、作者贡献留在脑子里时，学位论文就会腐烂。 STORY 把整条保管链——证据、论断、发表记录、里程碑——搬进仓库本身。
一个仓库，一部论文
前置部分、章节、附录、图、表和参考文献在 manus/ 下各归其位——模板开箱即可编译，支持英文与简体中文。
只读证据层
STAR 研究成果、STAGE 论文材料或人工登记的文件，都以逐文件指纹快照存入 mates/。证据只进不出——绝不就地修改。
论文级连贯，落盘为证
notes/story.md 掌管中心论点，contributions.md 把每项贡献映射到证据与章节，outline.md 定下章节架构，claims.md 作为论断记录表把三者连在一起。
反虚构边界
manus/ 中每项定量论断要么追溯到 mates/ 中带指纹的条目，要么写成 \todo{...}——没有第三种状态。学校规则只能作为作者确认的事实写入 degree/；已发表论文是证据，不自动等于学位论文的最终表述。显式的 \todo 是一种状态；看似合理的虚构数字是缺陷。
追溯之外，还有署名
notes/publications.md 记录哪些章节复用了已发表内容、每位合作者贡献了什么、涉及哪些许可与文本重叠。证据可追溯不能替代作者贡献说明——STORY 两者都要，合作成果绝不会被说成独立完成。
里程碑即数据
培养项目实际要求的开题、考核、预答辩、答辩、修改和归档分别放在 milestones/<slug>/——收到的反馈逐字保留、逐点回应、结果记录冻结。只要还有必检项或未兑现的承诺，归档包就不能宣告就绪。
原生 AI 协作，与 STAR、STAGE 联动
十六个 skill 同时供给 Codex、Claude Code、Cursor、DeepSeek Harness、Kimi Code、Pi 和 Qwen Code——英文与中文双语，出自同一份共享 skill 源。一条命令即可从配套的 STAR 或 STAGE 仓库导入证据，也可以完全独立使用、人工登记材料。
仓库结构
九个目录。
一条研究主线。
缩写命名遵循 STAR 家族惯例：输入简短、搜索无歧义， 并且在每个 STORY 仓库中完全一致。
STORY/
├── manus/ # 学位论文
│ ├── main.tex # 入口——始终可编译
│ ├── main-zh.tex # 可直接构建的中文起始模板
│ ├── fronts/ # 摘要、致谢、声明等前置部分
│ ├── chaps/ # 章节：<n>_<slug>.tex
│ ├── backs/ # 附录等后置部分
│ ├── figs/ # 成图，附可编辑源文件
│ ├── tabs/ # 由证据生成的表格
│ ├── bibs/ # reference.bib
│ └── stys/ # story.cls · story.sty · story.bst
├── mates/ # 带指纹的证据——只读
│ └── MANIFEST.md # 指纹台账
├── degree/ # 学位档案、学校要求、委员会
├── notes/ # 总叙事、论断、提纲、发表记录
│ └── refs/ # 逐篇文献的阅读笔记
├── milestones/ # 开题 → 答辩 → 归档
├── tasks/ # 持久化待办与承诺
├── wkdrs/ # 构建产物与临时报告（git 忽略）
├── execs/
│ ├── run.sh # ← 唯一构建入口
│ ├── update.sh # 同步 skill；--adopt 安装骨架
│ └── scpts/ # import.sh · lint.sh · fmt.sh
├── .env # 本机配置（绝不提交）
└── AGENTS.md # 人与 agent 共享的约定
manus/手稿 — 学位论文的 LaTeX 源文件mates/材料 — 带指纹的证据快照，只读degree/学位事实 — 经作者确认的学校档案notes/写作元数据 — 总叙事、提纲与论断记录表milestones/里程碑 — 每次考核事件一个目录tasks/待办 — 持久化未决事项与反馈承诺wkdrs/工作目录 — 构建产物与临时报告，绝不提交scpts/脚本 — 证据导入与确定性检查论文工作流
十六个 skill。
全程留痕。
从导入证据到冻结归档——每个 skill 都把自己的状态写进项目文件， 整部论文在任何时候都可审计、可续作。
✦
搭建接好仓库，引入带指纹的证据。
$story-proj-adopt接入已有的硕士或博士学位论文而不做改动——勘察、记录，学校事实一律经作者确认。
$story-evid-curator从 STAR 或 STAGE 仓库导入证据、登记人工材料、刷新指纹，并完整性检查 mates/。
✦
规划确立论文主线与章节架构。
$story-syns-coach按照已确认的硕士或博士层级，确立研究主线和学位贡献。
$story-outl-planner把主线展开为连贯的章节架构，每章服务于全文论证。
$story-refs-curator为每条文献断言备好可核验的文献记录与阅读笔记。
✦
写作依据证据写作，绝不凭记忆。
$story-chap-drafter每次起草一章，依据确认的章节简报、论文主线与映射好的证据——缺失的数字写成 \todo{}。
$story-tabs-builder表格只取自 mates/ 证据——每个数据行一条 % src: 指纹锚点。
$story-figs-designer每张图端到端完成：用途、可编辑源文件、渲染 PDF、映射到证据的图注。
✦
打磨与审计统一文字。追溯每个数字。
$story-copy-editor清晰度、文风、术语与跨章衔接——事实、数字与论断范围不可动。
$story-clms-auditor每个数字与比较都追溯到指纹：匹配 / 不符 / 无来源。
$story-cite-auditor每个 \cite 都能解析；每条文献断言都能对照阅读笔记核验。
✦
考核审查、回应、答辩、归档。
$story-exam-reviewer对构建好的论文做与学位层级相称的模拟审查——贡献范围、连贯性、证据与答辩准备度。
$story-revs-resolver逐点跟踪并处理委员会反馈——收到的意见绝不就地修改。
$story-defn-builder准备答辩演示文稿，并对照论文逐一检查。
$story-depo-packer对照 degree/ 要求预检归档包，并冻结最终记录。
✦
纵览汇报整体流程，指明下一步。
$story-flow-status只读地图：章节、论断、证据与里程碑关口——并给出唯一下一步及其确切命令。从不写文件。
每个 skill 都同时供给 Codex、Claude Code、Cursor、
DeepSeek Harness、Kimi Code、Pi 和 Qwen Code——
英文与中文双语——出自 .agents/skills/ 下的同一份共享源。
快速开始
六步得到可编译的论文。
从模板全新开始——通用 class 开箱即可编译；学校模板与学位规则只在你确认后，
作为事实写入 degree/。
# 1 · 从 STORY 模板创建论文仓库——一部学位论文，一个仓库
❯ git clone https://github.com/wanghao9610/STORY my-thesis && cd my-thesis
❯ rm -rf .git && git init # 去掉 STORY 的历史
# 2 · 在持久学位档案中确认硕士或博士层级
❯ $EDITOR degree/profile.tex # degree_level: master | doctoral
# 3 · 配置本地运行环境
❯ cp .env.example .env && $EDITOR .env # RESEARCH_HOME（可选）· STORY_MAIN · LATEX_ENGINE · STORY_LANG
# 4 · 从配套的 STAR 或 STAGE 仓库导入证据——或把文件放入 mates/manual/
❯ bash execs/scpts/import.sh --source ../my-stage-paper --slug paper-a
# 5 · 构建与检查——新克隆开箱即可编译
❯ bash execs/run.sh
❯ bash execs/scpts/lint.sh
# 6 · 接入工作流——它会告诉你唯一的下一步
❯ $story-flow-status
❯