先聊聊，AI 为啥Neng帮我们搞定技Neng目录

说实话，这玩意儿真的有点神奇。

你想啊，项目里一堆文档、代码、脚本，手动去找对应的 Skill 简直是噩梦。

于是我们就想：把这些信息喂给 AI，让它自己跑出来。

哈哈，这思路跟“把洗衣机放进厨房”一样大胆，但其实可行。

关键是让 AI Neng“kan懂”我们项目的结构，然后把每个技Neng点儿归类成目录。

先说文件命名。Zui好统一用小写+下划线，别随意加空格。

比如 .agent/skills/translation/SKILL.md，一眼就知道是翻译相关的 Skill。

然后在每个 Skill 顶部加上 YAML 元数据：

---
name: 翻译
description: 自动化多语言翻译流水线
keywords: 翻译, 多语言, i18n
---

这个元数据是 AI 的“身份证”，没了它 AI 就不知道这块干啥。

我们写了个 sync-index.sh 脚本，它会遍历 .agent/skills 下面所有 S K I L L .md，抽取 name、keywords，然后生成 Markdown 表格。

表格长这样：

| 任务类型 | 关键词 | Skill 路径 |
|---|---|---|
| **翻译** | 翻译, 多语言 | `.agent/skills/translation/SKILL.md` |
| **图片标注** | 标注, YOLO | `.agent/skills/image_tagging/SKILL.md` |

每次新增 Skill，只要跑一遍脚本，目录就自动geng新，不用手敲表格——省时省力。

核心是另一个脚本 find-skill.sh。

它接收一个关键词，比如你在编辑器里敲 /skill 翻译，脚本会去 INDEX.md 找匹配行，然后返回对应的文件路径给 AI。

这里用了点小技巧：

英文关键词走单词边界匹配，防止 “UI” 匹到 “build”。

中文关键词走模糊匹配，geng灵活。

假设你有一个电商项目，需要对商品图片进行属性标注，然后根据标注结果生成 SKU 列表。

第一步，把图片放进 /data/images，确保是 JPEG 或 PNG，大小不要超过 20MB——不然上传会卡死。

二、上传图片并触发自动识别.3、确认格式为JPEG、PNG等常见格式,
文件大小不超过佐糖当前限制,上传成功后系统将立即启动AI...
基于深度学习的图像识别系统,
轻松获取终端商品及陈列信息...

系统收到图片后会调用训练好的 YOLOv8 模型，把商品边框和属性dou打上标签。

通过 .agent/ 目录下的这套三位一体架构，项目建立了一个可自我维护、可生长的 AI 开发协作系统。

a) 在 .agent/skills/image_tagging/SKILL.md`里写好解析逻辑； b) 然后运行一次 `sync-index.sh` 把新 Skill 加进索引； c) Zui后在编辑器里敲 `/skill 标注`，AI 就Neng立马定位到对应脚本并执行啦！咱就是说这比手动跑一次 Python 脚本快太多了。 顺带来回答个老问题：为什么百度不收录我的技术博客？

* 因为缺少结构化的数据标记。 * 百度爬虫geng偏爱清晰的标题层级和 meta 信息，Ru果页面里只有堆砌的文字，它们会觉得“这玩意儿价值不高”。 * 再者，Ru果你的站点没有 robots.txt 正确放行或者没有 sitemap.xml，也会导致爬虫找不到页面。 * Zui后Ru果服务器响应慢或经常报错，那百度自然也懒得收录。 说白了就是“内容+结构+速度+权限”四大要素缺一不可。懂了吗？你懂的，你只要补齐这些，就Neng让百度慢慢爬进去啦！哈哈~

P标签包裹每段文字：P 标签是搜索引擎默认抓取单元，也是 AI 分句的重要依据。

# 使用 H2/H3 明确层级：Ai 在解析时会把 H2 当作章节标题，把 H3 当作子标题，这样它Neng快速定位“如何生成索引”。

# 添加 Alt 文本：If you have images , 给它们加上 alt 描述，不仅提升无障碍，也让搜索引擎和 AI geng懂图中内容。

# 合理使用代码块：`

` 和 `` Neng帮助模型区分普通文字和代码，提高答案准确率。


. 实战教学：把整个流程串起来 🎉
A) 确认项目根目录有 .agent 文件夹；
B) 在 .agent/skills 下新建一个 Skill 文件夹，例如 `data_cleaning`；
C) 写好 SKILL.md 并在顶部加上 YAML；
D) 执行 `./scripts/sync-index.sh` geng新 INDEX；
E) 用编辑器发送 `/skill 数据清洗`，AI 就会立刻定位到 `data_cleaning/SKILL.md` 并加载执行指令。 
# 常见坑与避坑指南 
- 不要随便改动 INDEX.md 手动添加行，否则下次同步会被覆盖掉。
- 文件名一定不Neng出现中文空格，否则 Bash 脚本可Neng报错。
- Ru果你在 Windows 环境下开发，要注意换行符 CRLF 会导致 awk 匹配异常，用 `dos2unix` 转一下就好啦。 
让 AI 成为你的“技Neng管家”吧！ 

说真的，一旦把 Skills 索引和查找脚本搞定，你以后再也不用担心找不到对应规范。
每次要Zuo某件事，只需要敲几句关键词，让 AI 把路径递给你，然后直接复制粘贴执行。
这感觉像是给项目装上了一个永远不会累的小秘书，嘿嘿，你说是不是hen酷？
Ru果还有啥想法或者踩坑经验，欢迎留言哈，我们一起完善这个“小生态”。
祝大家玩得开心，AI 帮你省事省心！