/tags/skills/ Recent content in skills on Hugo -- gohugo.io en Wed, 22 Apr 2026 12:26:02 +0800 /posts/personal-skill-set-for-ai-coding-agents/ Wed, 22 Apr 2026 12:26:02 +0800 /posts/personal-skill-set-for-ai-coding-agents/ 为什么同时用几个 coding agent，配置会越写越乱？ 单用一家 coding agent 时，指令写在哪其实不是问题——它能读到就行。但从第二家开始，问题就来了：同一条"运行测试用什么命令"要在 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md 里各写一份；同一份 “PR review 流程” 要在 .claude/skills/、.qwen/skills/、.agents/skills/ 里各放一份副本。维护一阵之后，哪份落后了、哪份还没更新，基本靠记忆。 这篇笔记就是围绕这件事展开的：哪些内容应该共享、哪些注定各写各的、共享的那部分怎么组织才不至于每次都手抄。 “always-on 指令"和 “skill” 到底不是一回事？ 先把两个经常被混用的词分开。 Always-on 指令文件：agent 启动时就加载到系统提示里、每次对话都在的那一段。Claude Code 的 CLAUDE.md、Codex 的 AGENTS.md、GitHub Copilot 的 .github/copilot-instructions.md 都是这一类。 Skill：放在 agent 能扫到的目录下的独立指令，主文件叫 SKILL.md、每个 skill 一个子目录。按这些产品目前公开文档的描述，正文通常不默认加载，而是在相关任务出现时再被纳入上下文。 换成提示词工程的类比：always-on 对应"不管你说什么都先念一遍的系统提示”，skill 对应"用户说到特定事情时才从抽屉里拿出来的那份 SOP"。两者能共存，但职责不一样——把它们混在一个大文件里，维护成本会随数量线性上升。 后文讨论的核心只有一条：skill 这一层怎么跨 agent 共享一份源，always-on 那一层为什么我反而劝你各写各的。 四家 agent 把这两层分别放在哪？ 到 2026 年，大致是这样（详细路径见后面的落地映射表）： Claude Code：always-on 是 CLAUDE.md；skills 在 ~/.claude/skills/ 或 .claude/skills/。 Qwen Code：原生支持 SKILL.md 技能目录，个人级 ~/.qwen/skills/、项目级 .qwen/skills/。 Codex：always-on 是 AGENTS. /posts/npx-skills-superpowers-multi-agent/ Sun, 29 Mar 2026 10:00:00 +0800 /posts/npx-skills-superpowers-multi-agent/ 同时维护多个 AI coding 工具是越来越常见的选择。我本地同时使用 Claude Code、GitHub Copilot、Gemini CLI、Qwen 和 OpenCode。 每个工具在正式使用前通常都需要一定的配置，让它了解你的工作方式——比如"先写测试再写实现"，或者"遇到 bug 先系统排查再动手改代码"。 问题在于，每个工具的配置文件格式各不相同： Claude Code 读取 CLAUDE.md GitHub Copilot 读取 .github/copilot-instructions.md Gemini CLI 读取 GEMINI.md OpenCode 读取 OPENCODE.md 这意味着同一套工作方式的描述，需要在多个文件里重复维护。有没有更省事一点的方式？ 背景：多 agent 的配置碎片化问题 想象你希望所有 AI 工具都遵循 TDD（测试驱动开发）——先写失败的测试，再写最小实现，再重构。 在以前，你需要把这套描述分别写入每个工具的配置文件。一旦你想调整措辞或补充细节，就得同步修改多处。更麻烦的是，这些配置不太方便和别人共享，也不容易直接复用社区里整理好的工作流配置。 Skills 生态系统可以在一定程度上缓解这个问题。 Skills 生态：统一的能力扩展标准 Skills 是一套开放的约定：将 AI agent 的工作方式描述为 Markdown 文件，统一存放在项目的 .agents/skills/ 目录下。支持这套约定的工具通常会按约定读取这个目录，因此不需要为每个工具分别维护一套格式。 这套标准由三个部分组成： skills.sh — 公共 skills 目录，可以浏览和搜索社区发布的 skills npx skills CLI — 命令行工具，用于发现、安装和管理 skills 本地 .agents/skills/ 目录 — skills 的实际存储位置，可以通过 Git 提交和共享 常用命令：