关于 using-superjawn
介绍如何在 Claude Code、Codex、Copilot CLI、Gemini CLI 等环境中发现和调用技能,并说明如何适配各客户端的工具。内容强调先检查适用技能,再按优先级遵循其工作流程。
主要功能
- 01技能调用指引
- 02按环境说明访问方式
- 03用于平台适配的工具映射
- 04技能优先级与类型说明
- 05处理用户指令的规则
适用场景
- 01判断任务是否适用某项技能
- 02查找特定环境中的技能访问方式
- 03将技能工作流程适配到可用工具
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jamditis/ claude-skills-journalism --skill using-superjawn安装后在 Claude Code 中输入/using-superjawn确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/codex-tools.mdcopilot-tools.mdgemini-tools.md详细介绍
如果某项技能适用于你的任务,你别无选择,必须使用它。
这不是商量的余地,也不是可选项。你不能为自己找借口。
指令优先级
superjawn 技能覆盖默认系统提示行为,但用户指令始终优先:
- 用户的明确指令(
AGENTS.md、CLAUDE.md、GEMINI.md和直接请求),优先级最高 - superjawn 技能,在冲突时覆盖默认系统行为
- 默认系统提示,优先级最低
如果项目指令文件(Codex 的 AGENTS.md、Claude Code 的 CLAUDE.md 或 Gemini CLI 的 GEMINI.md)写明“跳过研究阶段”,而某项技能要求“始终先研究”,请遵循用户的指令。用户拥有决定权。
如何访问技能
**在 Claude Code 中:**使用 Skill 工具。调用技能后,其内容会加载并呈现给你;请直接遵循。不要使用 Read 工具读取技能文件。
**在 Codex 中:**技能会从技能目录中原生加载。打开列出的 SKILL.md 并直接遵循。
**在 Copilot CLI 中:**使用 skill 工具。技能会从已安装的插件中自动发现。
**在 Gemini CLI 中:**使用 activate_skill 工具。Gemini 会在会话启动时加载技能元数据,并按需加载完整内容。
**在其他环境中:**请查阅客户端文档,了解技能发现和加载方式。
平台适配
技能描述的是能力,而不是特定供应商的工具名称。请使用与所请求操作相匹配的客户端文件、shell、计划和工作者功能。具体工具名称请参阅 references/codex-tools.md(Codex)、references/copilot-tools.md(Copilot CLI)或 references/gemini-tools.md(Gemini CLI)。Gemini CLI 用户会通过 GEMINI.md 自动加载工具映射。
使用技能
规则
**在回复或执行任何操作之前,先调用相关或指定的技能。**即使某项技能只有 1% 的可能适用,也应调用它进行确认。如果调用后发现该技能并不适用,则无需使用。
digraph skill_flow {
"User message received" [shape=doublecircle];
"About to EnterPlanMode?" [shape=doublecircle];
"Already brainstormed?" [shape=diamond];
"Invoke brainstorming skill" [shape=box];
"Might any skill apply?" [shape=diamond];
"Load relevant skill" [shape=box];
"Announce: 'Using [skill] to [purpose]'" [shape=box];
"Has checklist?" [shape=diamond];
"Create one task-list item per checklist item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"About to EnterPlanMode?" -> "Already brainstormed?";
"Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];
"Already brainstormed?" -> "Might any skill apply?" [label="yes"];
"Invoke brainstorming skill" -> "Might any skill apply?";
"User message received" -> "Might any skill apply?";
"Might any skill apply?" -> "Load relevant skill" [label="yes, even 1%"];
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
"Load relevant skill" -> "Announce: 'Using [skill] to [purpose]'";
"Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
"Has checklist?" -> "Create one task-list item per checklist item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"Create one task-list item per checklist item" -> "Follow skill exactly";
}
警示信号
出现以下想法时,请停下来:你正在为自己找借口。
| 想法 | 实际情况 |
|---|---|
| “这只是个简单问题” | 问题也是任务。检查技能。 |
| “我需要先了解更多背景” | 检查技能应先于澄清问题。 |
| “我先看看代码库” | 技能会告诉你如何检查。先检查技能。 |
| “我可以快速查看 git/文件” | 文件不包含对话背景。检查技能。 |
| “让我先收集信息” | 技能会告诉你如何收集信息。 |
| “这不需要正式技能” | 如果存在技能,就使用它。 |
| “我记得这个技能” | 技能会不断更新。请阅读当前版本。 |
| “这不算任务” | 采取行动就是任务。检查技能。 |
| “技能有点大材小用” | 简单的事情也可能变复杂。请使用技能。 |
| “我先做这一件事” | 行动前先检查。 |
| “这看起来很有效率” | 缺乏纪律会浪费时间。技能能避免这种情况。 |
| “我知道这是什么意思” | 理解概念不等于使用技能。 |
技能优先级
如果有多项技能可能适用,请按以下顺序使用:
- 流程技能优先(头脑风暴、调试)——这些技能决定如何开展任务
- 实施技能其次(frontend-design、mcp-builder)——这些技能指导执行
“我们来构建 X”→先头脑风暴,再使用实施技能。 “修复这个 bug”→先调试,再使用特定领域技能。
技能类型
严格型(调试、验证):严格遵循,不要偏离规范。
灵活型(模式):根据上下文调整原则。
技能本身会说明属于哪种类型。
用户指令
指令说明要做什么,而不是怎么做。“添加 X”或“修复 Y”不代表可以跳过工作流。