大家好,我是小虎。
学习群里的小伙伴让我多写一些关于skill的文章。
昨晚写文章,手里的咖啡差点洒键盘上。☕️
我们都在把最先进的 AI,用成了最笨的样子。
你有没有这种经历?让 AI 在 Windows 上跑个简单的命令,比如:
powershell.exe -NoProfile -Command "ssh -o ConnectTimeout=2 'web_user@10.0.8.25' 'mysql -e "SELECT "id", "name" FROM logs WHERE level = "ERROR" LIMIT 5"' 2>&1 || echo -e "\n--- 指令执行完毕 ---""
结果因为它搞不清 PowerShell 的转义规则,直接报错。
最气人的是,它自己还觉得能修好,于是一遍遍重试,一遍遍报错。你眼睁睁看着它陷入死循环,浪费了大量的 token 和宝贵的时间,怎么改都改不对。🤯
最后你实在受不了了,只能强行打断它的动作,像教小学生一样这一字一句地告诉它:
用powershell的时候,如果是字符串,则首尾用双引号,中间用单引号,反之亦然”
如果不厌其烦地重复这句话是人类的本质,那我宁愿承认自己老了。😅
作为一名在代码堆里趴了 20 年的技术人,我实在受不了这种低效。所以,今天小虎必须带你搞点“工业化”的王炸操作——用 Google Antigravity 的 Agent Skills,给你的 AI 伙伴装上一个“外挂大脑”。
让它从“一直犯错一直改”的死脑筋,变成“一次做对”的超级助理。这才是普通人利用 AI 实现超级个体的正确姿势。🚀
🎯 本文目标
别再做“人肉纠错仪”了。
今天我们只做一件事:配置一个“ PowerShell 引号纠正”技能。
花 5 分钟配好,以后你在项目里让 AI 写命令行,它会自动遵守 Windows 的江湖规矩,不仅懂你,还“预判”你的环境。这就叫降维打击。👊
📋 前置准备
- ✅ 环境:Google Antigravity IDE(能打开就行)
- ✅ 心态:准备好体验一下“刚说完上半句,AI 就懂下半句”的爽感。
🔧 核心实操 (Step-by-Step)
Step 1: 搞懂“地盘”(作用域)
这东西分两层,就像家规和国法:
| 作用域 | 路径 | 小虎大白话 |
|---|---|---|
| 项目级 (Workspace) | <项目根目录>/.agent/skills/ | 公司的法。团队里谁来都得守。 |
| 全局级 (Global) | ~/.gemini/antigravity/skills/ | 你的私房菜。不管去哪个项目,你的个人习惯都在。 |
👉 小虎建议:PowerShell 这种系统级的痛点,建议直接配在全局级,这样以后不管开什么新项目,它都记得住。但为了演示方便,我们在项目级先跑通。
Step 2: 搭架子(创建目录)
在你的项目根目录下,建立这个文件夹结构。
😅 踩坑故事: 以前每次让 AI 写 Git 提交命令,它老是用 Linux 的习惯:git commit -m 'feat: add "feature"'。 在 PowerShell 里,单引号里的内容经常被截断或者无法解析,导致直接报错。 Agent 一旦陷入这个坑,就怎么也爬不出来,一直重试一直错。 每次我都必须暂停,输入那句“咒语”:“用 powershell 的时候,如果是字符串,则首尾用双引号,中间用单引号,反之亦然”。
这种重复问题,做成 skill 就是最好的应用场景,我们来彻底终结这个问题。
你的项目/
└── .agent/
└── skills/
└── powershell-fixer/ <-- 给它起个霸气的名字
└── SKILL.md <-- 核心配置文件
懒人命令(直接复制跑):
# Windows PowerShell
mkdir -Force .agent/skills/powershell-fixer
Step 3: 注入灵魂(编写 SKILL.md)
新建 SKILL.md。来,把下面这段 YAML 和 Markdown 完整复制进去,一个字符都别改:
---
name: powershell-fixer
description: Critical Guide for generating PowerShell commands. Apply this skill whenever the user asks to generate, run, or fix CLI commands on Windows.
---
# PowerShell 命令生成规范
当检测到用户在 Windows 环境(PowerShell)下执行命令时,必须严格遵守以下引号规则:
## 1. 核心铁律:外双内单
- **严禁**使用 Bash 风格的外部单引号(如 `'some value'`)包裹带空格或特殊字符的参数。
- **必须**使用双引号包裹整个字符串参数。
- 内部如果包含字符串,优先使用单引号。
**❌ 错误示范 (Bash Habit):**
`git commit -m 'feat: implement "login" feature'`
-> *PowerShell 直接报错或解析混乱*
**✅ 正确示范 (Windows Way):**
`git commit -m "feat: implement 'login' feature"`
-> *完美运行*
## 2. 转义规则
- 如果必须在双引号内部使用双引号,必须使用反引号 `` ` `` 进行转义(例如 `` `"` ``),而不是反斜杠 ``。
💡 原理揭秘: 看到最上面的 description 了吗?那是给 AI 看的“触发器”。 我们明确告诉它:只要涉及 "generating PowerShell commands" ,就必须加载这段记忆。这就好比你在它脑子里植入了一个条件反射:一碰到 Windows 命令行,马上切换到“防炸模式”。
Step 4: 见证奇迹(验证效果)
- 关键一步:点击 IDE 的
+号,开启一个新的 Chat Session。(敲黑板:旧对话里没有加载新技能,别问我是怎么知道的,说多了都是泪 😭) - 输入 指令:
帮我提交个 commit,信息是:feat: integrated "user login" module
-
(注意:我故意在信息里混用了空格和双引号,这是最容易让 AI 翻车的场景)
-
看结果(爽点时刻) :
- ✅ Before:AI 傻乎乎地给你生成
git commit -m "feat: integrated "user login" module",你在终端一跑,直接红字报错。 - ✅ After:AI 就像开了天眼,直接生成:
-
git commit -m "feat: integrated 'user login' module"
- ✅ Before:AI 傻乎乎地给你生成
那一刻你会感觉,它不再是个只会照搬 Linux 教程的书呆子,它终于懂了 Windows 的“江湖规矩”。✨
⚡ 进阶:让 AI 真正的“动手”
除了定规矩,还可以定义一个能创建 Skills 的 skill。
比如你可以直接和 Antigravity 说:
请帮我创建一个规避powershell转义错误的skill
那上面的所有步骤,你都可以不用自己做了,让 AI 自己做掉。
从“动嘴皮子”到“动手干活”,这才是 Agent 真正的进化形态。这也是我们摆脱“搬砖”命运,建立个人护城河的关键一步。
📝 写在最后
以前带新人的时候,最烦的就是一遍遍教他:Windows 和 Linux 不一样。 现在好了,写一份 SKILL.md,AI 比人听话多了。
Agent Skills 的本质,其实是你个人经验的“数字化资产”。 你把你踩过的坑(比如单引号转义),固化成代码(Skill)。
把它存下来,这些隐性的知识,就是你在这个 AI 时代最大的被动收入来源。
快去试试吧,别让你的 AI 再“裸奔”了。🚀