Skip to content

定制成课题组的技能 ​

每个课题组都有自己的写作习惯、术语、常投的会议和实验规范。把这些写进技能,组里每个同学的 Agent 就会遵守同一套规则,新同学进组也能更快上手。

方式一:只改配置(推荐先试) ​

LaTeX 检查规则 ​

在论文目录放一个 .latexlint.json,只写需要改的项:

json
{
  "title_max_words": 12,
  "abstract_words": [150, 250],
  "extra_term_pairs": [["KV cache", "KV-cache"], ["edge server", "edge-server"]],
  "extra_abbr": ["DiT", "MoE", "TTFT"],
  "extra_venues": {"SoCC": "symposium on cloud computing"},
  "disable": ["voice-mix"]
}

把它放进课题组的论文模板仓库,每个人建新论文时就自动带上了。全部设置项见 rules.md。

论文速递的方向 ​

把课题组的 arxiv-digest.json(研究方向和关键词)放在共享位置,每个人复制一份,再按自己的子方向增减关键词。

方式二:复制一份后修改 ​

需要改规范条文、加新规则、加组内特有的流程时:

  1. 下载全部技能,放进你们课题组自己的仓库(源码仓库公开后也可以直接 fork);

  2. 修改你需要的部分:

    想改什么改哪里
    写作规范的条文skills/latex-lint/references/norms.md
    检查规则skills/latex-lint/scripts/texlint.py(每条规则是 Checker 类的一个方法)
    投稿清单skills/submission-check/references/checklist.md
    实验检查清单skills/bench-audit/references/checklist.md
    读论文的笔记模板skills/paper-reading/references/note-template.md
    复现报告模板skills/repro-log/references/report-template.md
  3. 改完运行测试:uv run pytest(或 python3 -m pytest;测试在源码仓库的 tests/ 目录,下载的压缩包里不含测试);

  4. 组里的同学从你的仓库安装:把改好的 skills/ 打包发给大家解压到技能目录;如果放到了 GitHub,也可以用 npx skills add 你的账号/research-skills。

方式三:写一个新技能 ​

把组里反复做的事写成技能,例如“按组内模板写周报”“提交 GPU 集群任务前的检查”。一个技能就是一个文件夹:

text
skills/weekly-report/
├── SKILL.md          # 必需:说明书
├── scripts/          # 可选:脚本
└── references/       # 可选:模板、规范等参考资料

SKILL.md 的开头是名称和描述,Agent 靠描述判断什么时候使用这个技能:

markdown
---
name: weekly-report
description: 按课题组的模板写周报:本周完成、遇到的问题、下周计划、需要的帮助。用户说“写周报”“整理这周的进展”时使用。
---

# 周报

1. 先问用户这周做了什么,或者读取用户给的实验记录、提交记录。
2. 按 references/template.md 的格式整理……
3. “遇到的问题”要写具体:报错信息、已经尝试过的方法……

几条经验:

  • 描述要写清“什么时候用”,包括用户可能的说法(中英文都写)。描述太笼统,Agent 就不知道该不该用。
  • 能用脚本完成的检查,就写成脚本。脚本的结果稳定、可复核,也更省 Agent 的上下文。
  • 写清边界:哪些事不能做(编造数据、直接改论文),哪些情况要先问用户。
  • 说明书写短一些,细节放到 references/ 里,Agent 需要时再读。
  • 写好以后用几句不同的说法测试,看 Agent 能不能在该用的时候用上它。Anthropic 官方的 skill-creator 技能可以帮你起草和测试。

本站的 19 个技能都可以作为参考,源码在 skills/ 目录。