manuscript-as-code
Treat manuscripts as software: version control, reproducible builds, figure pipelines, CI, and structured repo layout. Helps teams avoid 'final_v7' …
它会碰到什么
扫了多少2 个文本文件,2 KB
它会碰到什么不碰外部(只输出文字)
命中总数0 处
命中统计严重 0 · 高 0 · 中 0 · 低 0
这一栏是扫描器报的事实,不是结论。命中多不等于有毒(安全工具、规则库、示例脚本本来就会包含危险写法),命中少也不等于干净。它和你手上的凭据、文件、网络有什么关系,需要你自己看。
技能内容
Manuscript as Code(论文工程化)
目标
把“写论文”升级成“交付可复现的出版工程”:
- 结构清晰:任何人进仓库都知道哪里改正文、哪里改图、哪里改引用
- 可复现:一条命令能构建 PDF/HTML;CI 自动验证
- 可审计:每张图/每个结果都有来源(代码/数据/参数)
适用:
- 多人协作写作(导师/合作者/跨机构)
- 反复投稿/返修(需要明确改动轨迹)
- 图表多、实验多、容易“找不到版本”的项目
推荐仓库结构(最小可行)
见 templates/repo-structure.md。核心思想:
manuscript/:只放正文与引用(source-of-truth)figures/:每张图一个目录(source + out)build/:所有生成物(可删除,可再生)submission/与revision/:投稿与返修阶段产物
元规则(工程化的关键)
1) 生成物与源文件分离
- 源:
figures/fig-02/src/plot.py - 产物:
figures/fig-02/out/fig-02.pdf - 禁止把产物当源文件编辑(比如在 PDF 上涂改)
2) 每张图都要能“重生成”
最少要求:
- 一条命令 + 固定参数能导出最终图(PDF/TIFF)
- 记录依赖版本与随机种子(如果有)
3) 把“投稿约束”写成配置
推荐维护:
submission/submission-manifest.yml(统一记录规格与完成度)
案例(推荐学习)
- Manubot:
manubot/rootstock(论文的 CI/协作写作范式) - Deep review:
greenelab/deep-review(评审/返修视角)
想直接用这个技能?
本站把开放许可(MIT / Apache 等)的技能按仓库打包整理到网盘,点一下转存到你自己的网盘,不用一个个从 GitHub 拉。许可未声明的技能只给原始仓库链接,不打包。
它属于哪个仓库
星标★ 3,314
本站分层T1
该仓技能数258
原文件路径
bundled/skills/manuscript-as-code/SKILL.md