Claude Scholar开发者指南从零创建自定义科研技能完整教程【免费下载链接】claude-scholarSemi-automated research assistant for academic research and software development. Supports Claude Code, Codex CLI, Kimi Code CLI, and OpenCode across ideation, coding, experiments, writing, and publication.项目地址: https://gitcode.com/gh_mirrors/cl/claude-scholarClaude Scholar 是一款面向学术研究与软件开发的半自动科研助手支持 Claude Code、Codex CLI、Kimi Code CLI 与 OpenCode覆盖选题、编码、实验、写作与发表全流程。本文将带你从零开始创建属于自己的自定义科研技能让 AI 助手真正学会你的研究习惯。一、先认识 Claude Scholar 的技能体系在 Claude Scholar 中技能Skill是装在skills/目录下的能力包一条黄金法则是一个技能只负责一项持久职责one skill one durable job。标准结构如下skill-name/ ├── SKILL.md # 技能主文件触发条件 工作流 ├── references/ # 深度参考资料按需加载 ├── examples/ # 真实示例输出 └── scripts/ # 确定性辅助脚本核心规则来自官方技能开发指南skills/skill-development/SKILL.mdSKILL.md保持精简只写目标、角色边界与默认工作流frontmatter 的description是技能的触发面决定它何时被调用不要引用不存在的文件也不要继承未经验证的旧名称二、快速安装 Claude Scholar3步上手git clone https://gitcode.com/gh_mirrors/cl/claude-scholar /tmp/claude-scholar bash /tmp/claude-scholar/scripts/setup.sh安装脚本scripts/setup.sh是备份感知、增量友好的覆盖的文件会先备份到~/.claude/.claude-scholar-backups/并保留你已有的 API 密钥、权限与 MCP 配置。日后更新只需git pull --ff-only后重跑安装脚本卸载则使用scripts/uninstall.sh只移除它记录在案的文件。 已有自己的~/.claude/CLAUDE.md安装器会原样保留它把官方版装为CLAUDE.scholar.md需要你手动合并想要的部分不会被自动覆盖。三、从零创建自定义科研技能5步标准工作流第1步检查现有环境避免重复造轮子动手前先浏览skills/目录。Claude Scholar 内置了 40 技能如选题规划的skills/research-ideation/、论文写作的skills/ml-paper-writing/。你的自定义技能应聚焦官方技能没有覆盖的科研环节比如实验室设备登记组会纪要结构化。第2步锁定技能契约回答4个问题这个技能做什么用户说哪些话会触发它它明确不做什么真正需要哪些配套资源references / examples / scripts如果技能只需要一个短工作流就保持简短——不要为了让目录看起来齐全而创建空目录。第3步编写 SKILL.md 与 frontmatter以实验记录技能为例--- name: experiment-log description: This skill should be used when the user asks to log experiment runs, track ablation results, or summarize experiment history. version: 0.1.0 ---frontmatter 写作要点用第三人称触发句式This skill should be used when the user asks to…放入 3~5 个用户自然会说的短语name与目录名保持一致避免漂移第4步保持主文件精简好的SKILL.md通常只包含简短目标、角色边界、默认工作流、安全/质量规则、资源清单。模板、冗长清单、边界情况目录一律下沉到references/。可以参照内置的精简范例skills/daily-coding/SKILL.md——不到 80 行结构与边界一目了然。第5步只添加真实存在的配套资源references/可能按需加载的深度指南examples/真实的示例输出或脚手架scripts/确定性逻辑的辅助脚本铁律在SKILL.md中提到就必须存在存在但从未被引用就删掉。四、质量检查给你的技能打个分技能写完不是终点。用官方质量评审技能skills/skill-quality-reviewer/SKILL.md做一次体检它会从4个维度加权打分并给出等级维度权重关注点描述质量25%触发短语是否具体、是否第三人称内容组织30%SKILL.md 是否精简、细节是否进 references写作风格20%祈使句开头、客观指令语气结构完整25%frontmatter 齐全、引用文件真实存在拿到报告后skills/skill-improver/SKILL.md可以自动执行改进计划解析优先级 → 备份原文件 → 应用修改 → 生成更新报告形成评审—修复闭环。收尾前建议对照两份清单自查skills/skill-development/references/checklist.md触发质量、主文件质量、资源完整性skills/skill-development/references/integrity-checks.md死链引用、陈旧命名、缓存残留等常见故障模式五、新手常见坑位清单⚠️技能不触发description 写得太泛如 helps with tasks补上用户口语化的触发短语⚠️主文件超长超过 5000 词会稀释注意力把长清单下沉到references/⚠️死引用SKILL.md提到但从未创建的文件是最常见的故障⚠️name 漂移frontmatter 的name与目录 slug 不一致会导致定位混乱 感谢 APIMart 与 Kimi 团队对 Claude Scholar 开源科研助手项目的赞助与支持。结语检查环境 → 锁定契约 → 编写 SKILL.md → 质量打分 → 自动改进这套流程可以让你在 30 分钟内产出第一个可复用的科研技能。建议从最小可用的技能起步如实验记录、文献速读再借助质量评审让它持续进化——这正是 Claude Scholar 人做决策、助手加速流程设计理念的体现。【免费下载链接】claude-scholarSemi-automated research assistant for academic research and software development. Supports Claude Code, Codex CLI, Kimi Code CLI, and OpenCode across ideation, coding, experiments, writing, and publication.项目地址: https://gitcode.com/gh_mirrors/cl/claude-scholar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考