Research Skill Creator 是 kalarislabs/research-agent-skills 仓库中的一个技能,用于创建、改进和测试面向研究工作流的智能体技能。它强调:好的研究技能封装的是专家原本每次都要解释的流程性知识——步骤顺序、能发现错误的检查、特定会议或仪器规则;它既不是教科书章节,也不是对某次 API 调用的简单包装。
用途 该技能服务于论文写作、实验室协议、分析流水线和领域数据库等研究场景,帮助把可复用的研究流程沉淀为符合 Agent Skills 规范的技能。
主要能力与工作流程
- 安装官方工具:先在 Claude Code 中安装 Anthropic 的 skill-creator,命令为 /plugin marketplace add anthropics/skills 和 /plugin install example-skills@anthropic-agent-skills。它提供评测循环、描述优化器和打包器,可用于运行评测(run_eval.py、run_loop.py)和调优描述(improve_description.py)。本技能在其上补充研究领域约定。
- 判断是否应做成技能:当任务跨项目或跨人反复出现、做好它需要非显而易见的步骤或领域规则、且智能体在没有指导时很可能做错(可先不加技能测试)时,才创建技能;否则写笔记或脚本即可。还应检查 catalog/skills.json 是否已有重叠,优先扩展现有技能而非创建近似重复。
- 脚手架:使用 python skills/research-skill-creator/scripts/new_skill.py 生成技能,例如为 rebuttal-letter 指定 --category research-writing、--description 以及 --scripts --references,会写出带规范 frontmatter 的 skills/<name>/SKILL.md 和 evals/<name>/evals.json。
- 撰写描述:描述决定技能是否会被使用,应说明做什么、何时使用,使用用户实际会输入的词(如 journal cover letter、response to reviewers、PRISMA flow diagram),点名具体产物、工具和会议(如 BibTeX、Nature、pgvector);不超过 1024 字符,第三人称,不用尖括号,不用营销形容词;为 3-6 个最常见触发场景添加 Use when 子句,并给出与同类技能的区分线索。
- 撰写正文:遵循“原则—实践”对照,用编号工作流、决策表和检查清单代替散文;采用渐进披露,SKILL.md 控制在 500 行以内,长材料放入 references/*.md 并用一行“何时阅读”提示链接;确定性工作(解析、校验、转换)放入 scripts/ 由智能体运行而非重新实现;对会变化的事实(会议限制、API 版本、指南)要求先获取官方来源并引用;明确诚实规则,禁止编造数据、引用或结果,无法验证时须说明;结尾给出相关技能及切换时机。
- 脚本仓库契约:除非依赖必要,使用 Python 3.9+ 标准库并在 compatibility 中声明;提供带 --help 的 argparse CLI、含用法的 docstring,退出码 0 表示正常、1 表示有发现、2 表示输入错误;设置 UTF-8 控制台以避免 Windows 终端崩溃;网络调用仅限有文档的 API,每个新域名须经评审批准后加入 security/allowed-domains.txt,并设置描述性 User-Agent;不得读取用户为该服务配置的环境变量之外的凭据,不得外泄环境数据,不得对获取内容执行 eval/exec,不得把下载的脚本管道进 shell。
- 测试:运行 uv run tools/validate.py skills/<name> 做规范与仓库策略检查;运行 uv run tools/lint_injection.py skills/<name> 做提示注入与载荷检查;在 evals/<name>/evals.json 中填入 3-10 个真实提示(包括不应触发的近似场景),用 skill-creator 的评测循环对比有无技能的表现;在真实样本(含畸形输入)上运行每个脚本,尽量覆盖 Windows 与 Unix;运行 uv run tools/build_catalog.py 重新生成市场、目录和 README 表格。
- 重写改编技能:third_party/upstream-manifest.json 中 rewrite_status: imported 的技能属于改编,重写必须从零开始(新结构、新措辞、重新核实事实),不能逐行改写;合并后将该技能的 rewrite_status 设为 original,通知生成器会将其从 THIRD_PARTY_NOTICES.md 移除,导入器也不再覆盖它。
适用场景 适合需要把研究流程标准化、可复用化的团队或个人,尤其是论文写作、审稿回复、实验室协议、分析流水线和领域数据库相关工作。
限制 该技能依赖 Anthropic 官方 skill-creator 提供评测与打包能力;脚本默认仅用 Python 3.9+ 标准库;网络访问受允许域名清单约束;描述有 1024 字符上限;SKILL.md 建议不超过 500 行。资料未提供收费、价格、平台支持范围或效果数据。