新闻详情

新闻详情

首页 / 资讯中心 / 详情

如何在Gajae-Code中编写自定义SKILL.md技能?面向新手的完整教程

发布时间:2026/10/1 2:11:34来源:尧图网络
如何在Gajae-Code中编写自定义SKILL.md技能?面向新手的完整教程
如何在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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

AI找出数学反例推翻论文,作者确认,453篇手稿,AI开始自己出题了 2026/10/1 2:59:23

AI找出数学反例推翻论文,作者确认,453篇手稿,AI开始自己出题了

AI会做题之后,下一关,可能真的是:AI会不会选题。 AI数学,正在越过一个很微妙的分界线。 过去我们问的是:大模型能不能做出一道难题?能不能写出严谨证明?能不能找到人类几十年没发现的反例&…

阅读更多 →
工业采集数据跳变失准?限幅+中位值+卡尔曼三级滤波工程实战 2026/10/1 2:59:23

工业采集数据跳变失准?限幅+中位值+卡尔曼三级滤波工程实战

做工业上位机和数据采集的朋友,大概率都踩过模拟量跳变的坑。 现场环境大家都懂,变频器、接触器、动力电缆混在一起布线,传感器的4-20mA信号拉个三五十米到采集模块,读上来的数据就没稳过。轻则数值来回跳,界面看着晃眼…

阅读更多 →
一文讲清项目管理全流程!从立项到交付,真正要管住的是这5个阶段 2026/10/1 2:59:23

一文讲清项目管理全流程!从立项到交付,真正要管住的是这5个阶段

很多项目最典型的问题不是大家不干活,而是 从立项到交付,中间没有形成一条完整的管理链。 真正把一个项目管下来,其实就五个阶段: 项目启动 → 项目计划 → 项目执行 → 项目监控 → 项目收尾。 每个阶段该管什么、怎么落地&…

阅读更多 →
风格化渲染系统:从艺术规则到实时管线的工程实践 2026/10/1 2:59:23

风格化渲染系统:从艺术规则到实时管线的工程实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
二维Ising模型蒙特卡洛磁化分析:Metropolis算法与MATLAB实现 2026/10/1 2:59:22

二维Ising模型蒙特卡洛磁化分析:Metropolis算法与MATLAB实现

简介:基于Monte-Carlo模拟的二维Ising模型磁化分析系统,是一份使用MATLAB实现的数值模拟工具,面向凝聚态物理、材料科学等领域的研究人员和学生。它可在不开展复杂物理实验的情况下,预测铁磁材料在不同温度下的磁性能,…

阅读更多 →
微信小程序社区团购项目开发指南:从数据库设计到部署避坑 2026/10/1 2:59:15

微信小程序社区团购项目开发指南:从数据库设计到部署避坑

简介:一份面向计算机专业毕业设计的微信小程序社区团购系统完整开发资料包,内含项目源码、数据库脚本与配套论文,适合毕业设计、课程设计或学习SSM框架与小程序前后端联动开发的读者。资源共1246个文件,压缩后约22.61MB&#xff0…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉