القائمة
指导创建符合 Cursor 官方规范的 Agent Skill。当用户要求创建技能、编写 SKILL.md、或问到 skill 结构和最佳实践时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Go 语言项目的开发模式和最佳实践。当用户提到"写 Go 代码""Go 服务""Go 接口""goroutine""Go 测试"时使用。
macOS 桌面应用开发的模式和最佳实践。当用户提到"开发 Mac 应用""SwiftUI""Swift 代码""桌面应用""菜单栏应用"时使用。
创建或更新 Skill 的交互式 SOP，通过分步提问引导用户完成 Skill 设计与实现。当用户提到「创建 skill」「帮我做一个 skill」「更新 skill」时使用。
Agent 闭环自验证工作流，在完成代码修改后自动执行"写代码→构建→验证UI→查日志→修复→再验证"的完整循环。当 Agent 完成功能开发、Bug 修复、UI 修改、API 变更或任何代码改动后，应主动触发此验证流程，确保改动真正生效且无副作用。适用于 Web 前后端项目的闭环验证。
统一 AI 调用服务，三服务商策略（4sapi+sodao+OpenRouter），支持文本对话、图片理解、PDF/音视频分析、图像生成、流式输出、智能降级。当需要接入大语言模型或实现多模态 AI 功能时使用。
企微聊天记录查看方案，后端统一处理消息同步/解密/媒体下载/语音转文字，前端按业务场景分散在各模块。当需要展示聊天记录、实现会话历史查看或消息渲染时使用。
| name | create-skill |
| description | 指导创建符合 Cursor 官方规范的 Agent Skill。当用户要求创建技能、编写 SKILL.md、或问到 skill 结构和最佳实践时使用。 |
~/.cursor/skills/）还是项目 skill（.cursor/skills/）？如果有 AskQuestion 工具可用，用结构化问题收集；否则直接对话式询问。
skill-name/
├── SKILL.md # 必须 — 主指令文件
├── reference.md # 可选 — 详细文档
├── examples.md # 可选 — 使用示例
└── scripts/ # 可选 — 工具脚本
└── helper.sh
| 类型 | 路径 | 作用域 |
|---|---|---|
| 个人 | ~/.cursor/skills/skill-name/ | 所有项目可用 |
| 项目 | .cursor/skills/skill-name/ | 跟随仓库共享 |
禁止在 ~/.cursor/skills-cursor/ 下创建，该目录为 Cursor 内置技能保留。
---
name: your-skill-name
description: 简要描述做什么以及何时使用
---
# Skill 标题
## 使用方法
清晰的分步指导。
## 示例
具体的使用范例。
| 字段 | 要求 | 用途 |
|---|---|---|
name | 最长 64 字符，仅小写字母/数字/连字符 | 唯一标识 |
description | 最长 1024 字符，非空 | agent 据此决定是否应用该 skill |
description 是 skill 被发现和应用的关键。agent 根据它决定何时使用。
第三人称（description 会被注入系统提示词）：
"处理 Excel 文件并生成报表""我可以帮你处理 Excel 文件"具体 + 包含触发词：
"从 PDF 提取文字和表格，填写表单，合并文档。当处理 PDF 文件时使用。""帮助处理文档"同时包含 WHAT 和 WHEN：
上下文窗口与对话历史、其他 skill、请求共享。每个 token 都在竞争空间。
默认假设：agent 已经很聪明。只添加它不知道的上下文。
详细参考放入单独文件，agent 需要时再读取。
## 更多资源
- API 详情见 [reference.md](reference.md)
- 使用示例见 [examples.md](examples.md)
引用保持一层深度 — 从 SKILL.md 直接链接到参考文件。
| 自由度 | 何时使用 | 示例 |
|---|---|---|
| 高（文字指导） | 多种有效方案，依赖上下文 | 代码审查指南 |
| 中（伪代码/模板） | 有首选模式但允许变通 | 报告生成 |
| 低（具体脚本） | 脆弱操作，一致性关键 | 数据库迁移 |
## 报告结构
\`\`\`markdown
# [标题]
## 摘要
## 关键发现
## 建议
\`\`\`
## 提交消息格式
**示例 1：**
输入：添加了 JWT 用户认证
输出：`feat(auth): implement JWT-based authentication`
## 执行步骤
- [ ] 步骤 1: 分析输入
- [ ] 步骤 2: 生成映射
- [ ] 步骤 3: 验证结果
1. 执行操作
2. **立即验证**: `python scripts/validate.py output/`
3. 验证失败 → 修复 → 重新验证
4. **验证通过后才继续**
| 反模式 | 正确做法 |
|---|---|
Windows 路径 scripts\helper.py | scripts/helper.py |
| 选项过多 "可以用 A 或 B 或 C..." | 给一个默认方案，加逃逸口 |
| 时间敏感信息 "2025年前用旧API" | 用"当前方法"+"已废弃"分区 |
| 术语不一致 混用"端点/URL/路由" | 全文统一一个术语 |
模糊名称 helper, utils | 具体名称 processing-pdfs |
收集目的、存放位置、触发场景、约束条件、现有模式。