从零开发一个 AI Skill完整实战指南 常用 Skill 推荐本文不讲概念只讲怎么干。从项目初始化到上线部署每一步都给你可直接复制的代码和配置。最后附上我日常高频使用的 Skill 推荐清单。一、项目结构直接抄这个别自己瞎建目录标准结构长这样my-skill-name/ ├── SKILL.md # 核心指令文件唯一入口 ├── scripts/ # 确定性逻辑脚本Python/Bash ├── references/ # API文档、Few-shot示例 └── assets/ # 模板、图片等静态资源初始化命令python scripts/init_skill.py my-skill--path~/.config/skills/三个硬性规则文件夹名 name字段 module.json中的标识三处必须一致命名用 kebab-case如weekly-report-generator一个 Skill 只干一件事别贪多二、SKILL.md 怎么写这是整个 Skill 的灵魂文件分两部分YAML 头 Markdown 正文。YAML Frontmatter身份证---name:weekly-report-generatordescription:根据工作日志自动生成结构化周报。当用户说写周报、总结本周工作、生成weekly report时触发。allowed-tools:Read,Write,Bashversion:1.0.0license:MIT---⚠️description是最关键的字段——AI 靠它判断什么时候调用你的 Skill。写清楚两件事做什么什么时候触发。Markdown 正文执行指令用祈使句按模块写## 角色 你是一名资深项目经理擅长从杂乱日志中提炼工作重点。 ## 执行步骤 1. 提取本周已完成的任务列表 2. 识别阻塞项和风险点 3. 生成下周计划建议 4. 按模板输出 ## 输入校验 - 如果用户未提供日志文本主动询问 - 如果日志少于3条提示补充 ## 输出格式 使用三级标题### 本周进展 / ### 存在问题 / ### 下周计划 ## 示例 输入周一完成了登录模块重构周三修复了3个P2 bug周五在评审新需求 输出 ### 本周进展 - 完成登录模块重构 - 修复 3 个 P2 级别缺陷 - 参与新需求评审 ### 存在问题 - 无 ### 下周计划 - 跟进新需求排期防幻觉技巧在正文里明确写不要擅自补全业务规则、“不要编造数据”比你想的有用。三、性能优化省 Token 的核心手段别把所有内容塞进一个文件用三层分工层级内容加载时机大小控制L1name description常驻内存~100 词L2SKILL.md 正文触发后加载尽量精简L3scripts/ references/按需调用不占初始Token效果初始加载从数万 Token 降到约 100 词节省 60–90%。另一个关键操作确定性逻辑用脚本别让 LLM 推理。比如数据清洗、格式转换、文件重命名——这些写成 Python 脚本放scripts/里执行速度快 3–100 倍还不会出错。四、测试四层验证体系层次工具什么时候跑通过标准单元测试pytest每次提交覆盖率 ≥ 80%集成测试pytest httpxPR 合并前全部通过端到端自研脚本发布前核心流程跑通性能locust发布前P95 3s用例必须覆盖四类✅ 正向触发该触发时触发❌ 负向不触发不该触发时别乱触发⚠️ 边界条件空输入、超长输入 异常输入乱码、注入攻击五、部署上线 常见坑上线流程提交审核 → 平台初审 → 功能测试 → 安全审计 → 上线踩坑速查表现象原因解法Skill 无响应name/目录/module.json 不一致统一三处命名“function not found”方法名大小写不匹配直接复制粘贴 functionName执行卡住超时忘了回传完成信号所有分支都调completeArkTSScriptInAppAPI 被限流并行请求太多用 BufferedSender 指数退避1s→3s输入无效报错缺少必要参数ConditionalSkill 设默认值API 稳定性配置直接抄timeout:链路段P95 × 1.5retry:2次指数退避1s → 3scircuit_breaker:5分钟内超时率30% 自动熔断fallback:返回兜底文案 转人工六、常用推荐 Skill 清单以下是我日常高频使用、经过生产验证的 Skill按场景分类 效率工具类Skill干什么用亮点weekly-report-generator工作日志 → 结构化周报自动提取进度/风险/计划5秒出稿meeting-notes-summarizer会议录音转写 → 结构化纪要支持多说话人分离自动提取待办和责任人email-draft-assistant根据要点生成正式邮件支持多种语气正式/友好/催促自动加称呼落款 开发辅助类Skill干什么用亮点go-http-reviewerGo HTTP 服务代码审查聚焦安全漏洞、性能瓶颈、规范违规比通用审查精准10倍sql-query-optimizer慢查询分析 优化建议给出索引建议、SQL重写方案附执行计划对比api-doc-sync代码变更自动同步 API 文档监听 git diff自动更新 OpenAPI/Swagger告别文档滞后commit-message-generator根据 diff 生成规范 commit message遵循 Conventional Commits支持中英文 数据处理类Skill干什么用亮点data-cleaning-pipeline脏数据清洗 标准化封装 Python 脚本比纯 LLM 处理快 50 倍支持增量csv-to-chartCSV 数据 → 可视化图表自动识别数据类型选择最佳图表类型输出 PNG/SVGlog-anomaly-detector日志流异常检测实时识别错误模式、性能退化自动告警 根因定位 安全运维类Skill干什么用亮点secret-scanner代码仓库密钥泄露扫描支持 200 种密钥模式集成 CI/CD pipelinedependency-auditor依赖包安全漏洞审计对接 CVE 数据库按严重等级排序给出升级建议 选型建议优先选窄任务 Skill——审查 Go HTTP 代码比做全栈开发好用 10 倍组合使用——log-anomaly-detectorweekly-report-generator 自动生成含异常分析的周报看 description 质量——好的 Skill 会明确写触发词差的只写一句模糊描述有 scripts/ 目录的优先——说明作者把确定性逻辑脚本化了执行更稳定最后别想太多找一个你每天重复做的事写周报、审代码、清数据花 30 分钟把它封装成 Skill。第一次可能粗糙但跑起来之后你会发现问题然后迭代——这比看十篇教程有用。 从零开发一个 AI Skill：完整实战指南 + 常用 Skill 推荐
从零开发一个 AI Skill完整实战指南 常用 Skill 推荐本文不讲概念只讲怎么干。从项目初始化到上线部署每一步都给你可直接复制的代码和配置。最后附上我日常高频使用的 Skill 推荐清单。一、项目结构直接抄这个别自己瞎建目录标准结构长这样my-skill-name/ ├── SKILL.md # 核心指令文件唯一入口 ├── scripts/ # 确定性逻辑脚本Python/Bash ├── references/ # API文档、Few-shot示例 └── assets/ # 模板、图片等静态资源初始化命令python scripts/init_skill.py my-skill--path~/.config/skills/三个硬性规则文件夹名 name字段 module.json中的标识三处必须一致命名用 kebab-case如weekly-report-generator一个 Skill 只干一件事别贪多二、SKILL.md 怎么写这是整个 Skill 的灵魂文件分两部分YAML 头 Markdown 正文。YAML Frontmatter身份证---name:weekly-report-generatordescription:根据工作日志自动生成结构化周报。当用户说写周报、总结本周工作、生成weekly report时触发。allowed-tools:Read,Write,Bashversion:1.0.0license:MIT---⚠️description是最关键的字段——AI 靠它判断什么时候调用你的 Skill。写清楚两件事做什么什么时候触发。Markdown 正文执行指令用祈使句按模块写## 角色 你是一名资深项目经理擅长从杂乱日志中提炼工作重点。 ## 执行步骤 1. 提取本周已完成的任务列表 2. 识别阻塞项和风险点 3. 生成下周计划建议 4. 按模板输出 ## 输入校验 - 如果用户未提供日志文本主动询问 - 如果日志少于3条提示补充 ## 输出格式 使用三级标题### 本周进展 / ### 存在问题 / ### 下周计划 ## 示例 输入周一完成了登录模块重构周三修复了3个P2 bug周五在评审新需求 输出 ### 本周进展 - 完成登录模块重构 - 修复 3 个 P2 级别缺陷 - 参与新需求评审 ### 存在问题 - 无 ### 下周计划 - 跟进新需求排期防幻觉技巧在正文里明确写不要擅自补全业务规则、“不要编造数据”比你想的有用。三、性能优化省 Token 的核心手段别把所有内容塞进一个文件用三层分工层级内容加载时机大小控制L1name description常驻内存~100 词L2SKILL.md 正文触发后加载尽量精简L3scripts/ references/按需调用不占初始Token效果初始加载从数万 Token 降到约 100 词节省 60–90%。另一个关键操作确定性逻辑用脚本别让 LLM 推理。比如数据清洗、格式转换、文件重命名——这些写成 Python 脚本放scripts/里执行速度快 3–100 倍还不会出错。四、测试四层验证体系层次工具什么时候跑通过标准单元测试pytest每次提交覆盖率 ≥ 80%集成测试pytest httpxPR 合并前全部通过端到端自研脚本发布前核心流程跑通性能locust发布前P95 3s用例必须覆盖四类✅ 正向触发该触发时触发❌ 负向不触发不该触发时别乱触发⚠️ 边界条件空输入、超长输入 异常输入乱码、注入攻击五、部署上线 常见坑上线流程提交审核 → 平台初审 → 功能测试 → 安全审计 → 上线踩坑速查表现象原因解法Skill 无响应name/目录/module.json 不一致统一三处命名“function not found”方法名大小写不匹配直接复制粘贴 functionName执行卡住超时忘了回传完成信号所有分支都调completeArkTSScriptInAppAPI 被限流并行请求太多用 BufferedSender 指数退避1s→3s输入无效报错缺少必要参数ConditionalSkill 设默认值API 稳定性配置直接抄timeout:链路段P95 × 1.5retry:2次指数退避1s → 3scircuit_breaker:5分钟内超时率30% 自动熔断fallback:返回兜底文案 转人工六、常用推荐 Skill 清单以下是我日常高频使用、经过生产验证的 Skill按场景分类 效率工具类Skill干什么用亮点weekly-report-generator工作日志 → 结构化周报自动提取进度/风险/计划5秒出稿meeting-notes-summarizer会议录音转写 → 结构化纪要支持多说话人分离自动提取待办和责任人email-draft-assistant根据要点生成正式邮件支持多种语气正式/友好/催促自动加称呼落款 开发辅助类Skill干什么用亮点go-http-reviewerGo HTTP 服务代码审查聚焦安全漏洞、性能瓶颈、规范违规比通用审查精准10倍sql-query-optimizer慢查询分析 优化建议给出索引建议、SQL重写方案附执行计划对比api-doc-sync代码变更自动同步 API 文档监听 git diff自动更新 OpenAPI/Swagger告别文档滞后commit-message-generator根据 diff 生成规范 commit message遵循 Conventional Commits支持中英文 数据处理类Skill干什么用亮点data-cleaning-pipeline脏数据清洗 标准化封装 Python 脚本比纯 LLM 处理快 50 倍支持增量csv-to-chartCSV 数据 → 可视化图表自动识别数据类型选择最佳图表类型输出 PNG/SVGlog-anomaly-detector日志流异常检测实时识别错误模式、性能退化自动告警 根因定位 安全运维类Skill干什么用亮点secret-scanner代码仓库密钥泄露扫描支持 200 种密钥模式集成 CI/CD pipelinedependency-auditor依赖包安全漏洞审计对接 CVE 数据库按严重等级排序给出升级建议 选型建议优先选窄任务 Skill——审查 Go HTTP 代码比做全栈开发好用 10 倍组合使用——log-anomaly-detectorweekly-report-generator 自动生成含异常分析的周报看 description 质量——好的 Skill 会明确写触发词差的只写一句模糊描述有 scripts/ 目录的优先——说明作者把确定性逻辑脚本化了执行更稳定最后别想太多找一个你每天重复做的事写周报、审代码、清数据花 30 分钟把它封装成 Skill。第一次可能粗糙但跑起来之后你会发现问题然后迭代——这比看十篇教程有用。