如何在Gajae-Code中编写自定义SKILL.md技能面向新手的完整教程【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-codeGajae-Code 是一个 AI 编程代理 CLI 工具支持把专家经验写成纯文本的SKILL.md 技能文件让 AI 自动发现并执行。本文将手把手教你从零编写一个自定义 SKILL.md 技能只需要一个 Markdown 文件、两个配置位置、一条调用命令不需要编译、不需要配置中心新手也能 5 分钟上手。1. 什么是 SKILL.md 自定义技能在 Gajae-Code简称 GJC中技能Skill就是一个放在磁盘上的 Markdown 文件采用与 Claude Code、OpenAI Codex 相同的文件约定。它不是插件、不是脚本而是写给 AI 的操作说明书自动发现文件系统技能发现默认开启把合法的技能文件放进规范目录会话就会自动列出它无需任何注册步骤一行命令调用新会话中直接输入/skill:技能名即可调用AI 也会通过skill_discovery工具自行发现正文即提示词技能正文会以完整 Markdown 形式注入会话指导 AI 按你的流程工作。GJC 自带 4 个工作流技能autoresearch、deep-interview、ralplan和ultragoal它们始终可用且无法被同名的自定义技能覆盖这是受保护的保留名称撞名只会产生警告。2. 编写技能一个文件的 3 个关键点创建自定义技能只需要满足 3 个要求这也是新手最常踩的坑YAML frontmatter 必须位于文件第一行---开头否则扫描器会直接跳过并给出诊断提示frontmatter 必须包含name和description缺少description同样会被跳过正文用自然语言写清操作步骤——它会被完整读入上下文写得像给实习生的 SOP 就对了。一个最小可用的技能骨架如下代码量已经压到最小--- name: my-skill description: 当用户需要提交规范化的 Conventional Commits 时使用此技能 --- # My Skill ## 操作步骤 1. 先用 git status 确认变更范围 2. 按 type(scope): summary 格式生成提交信息 3. 提交前检查是否包含敏感信息description的写法很关键它同时是 AI 判断何时使用这个技能的依据建议以Use when …句式描述触发场景可参考官方技能 gjc-sdk-discover 的写法。3. 技能放在哪里2 个规范目录GJC 按作用域加载技能两个规范位置任选其一作用域目录位置适用场景项目级项目/.gjc/skills/name/SKILL.md只跟当前仓库走可提交给团队共享用户级~/.gjc/agent/skills/name/SKILL.md一次安装所有项目通用同名技能的优先级规则先命中者生效被遮蔽时会有诊断提示而非静默忽略项目级 优先于 用户级项目级内部从cwd向上走到仓库根离cwd最近的.gjc/skills胜出用户级内部config/agent/skills 旧的config/skills 旧的~/.gjc/skills。 完整的位置表、Claude Code / Codex 目录的导入方式与信任开关说明见官方文档docs/skills.md。4. 最快上手3 步安装并调用技能# 第 1 步放入技能以项目级为例 mkdir -p .gjc/skills/my-skill # 将第 2 节的骨架保存为 .gjc/skills/my-skill/SKILL.md # 第 2 步命令行检查发现结果 gjc skills discover第 3 步开一个新会话输入/skill:my-skill即可调用支持自动补全。如果你手头已有 Claude Code.claude/skills或 Codex.codex/skills格式的技能GJC不会静默加载它们但gjc skills discover会把它们识别为导入候选并直接给出对应的cp复制命令照做即可导入。5. 调试技巧技能没出现怎么办技能未生效时 GJC 会给出可执行的诊断信息而不是静默跳过常见原因对照表现象原因与对策提示缺少 frontmatter---块没有位于文件第一行提示缺少 descriptionfrontmatter 里补上description字段提示受保护名称冲突你用了ultragoal等 4 个保留名换个名字完全扫描不到检查信任开关例如gjc config set skills.trustProjectSkills false会屏蔽项目级技能善用这几个排查命令--json可输出结构化结果gjc skills discover # 查看全部技能与诊断 gjc skills discover --query 关键词 # 按名称/描述过滤 gjc skills discover --limit 10 # 分页查看6. 进阶向官方示例技能学写法仓库里自带了多份高质量技能范例强烈建议写之前先读一遍sdk-skills/gjc-sdk-author/SKILL.md —— 带模板目录templates/direct-sdk.ts、direct-sdk.py的技能写法展示技能可以附带模板文件sdk-skills/manifest.json —— 技能清单文件说明技能目录如何组织plugins/gajae-code/skills/ —— 插件内置技能如gjc-sdk-guides的纯参考资料型技能docs/extragoal-skill-template.md —— 一个可一键安装的完整本地技能模板外部评审门禁是学习复杂工作流技能的最佳范文docs/gjc-dogfood-skill-template.md —— 另一个本地技能模板演示内部流程固化成技能的模式。7. 总结自定义 SKILL.md 技能的核心要点步骤要点编写frontmatter 从第一行开始含namedescription放置项目级.gjc/skills/或用户级~/.gjc/agent/skills/调用新会话输入/skill:name或让 AI 自动发现调试gjc skills discover查看诊断勿与 4 个保留名冲突写技能的心法只有一句把你自己重复做过的流程写成一份 AI 能照章操作的说明书。从 10 行的小技能开始逐渐沉淀成团队共享的项目级资产——这就是 Gajae-Code 技能体系的精髓。【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考