diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..3584058c --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,565 @@ + +# 🌌 Antigravity Awesome Skills: 1,272+ 通用代理技能 适用于 Claude Code、Gemini CLI、Cursor、Copilot 及更多 + +> **面向AI编码助手的1,272+通用代理技能终极集合 — Claude Code、Gemini CLI、Codex CLI、Antigravity IDE、GitHub Copilot、Cursor、OpenCode、AdaL** + +[![GitHub stars](https://img.shields.io/badge/⭐%2021%2C000%20Stars-old?style=for-the-badge)](https://github.com/sickn33/antigravity-awesome-skills/stargazers) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai) +[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli) +[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex) +[![Kiro](https://img.shields.io/badge/Kiro-AWS-orange)](https://kiro.dev) +[![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh) +[![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot) +[![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode) +[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills) +[![AdaL CLI](https://img.shields.io/badge/AdaL%20CLI-SylphAI-pink)](https://sylph.ai/) +[![ASK Supported](https://img.shields.io/badge/ASK-Supported-blue)](https://github.com/yeasy/ask) +[![Web App](https://img.shields.io/badge/Web%20App-Browse%20Skills-blue)](apps/web-app) +[![Buy Me a Book](https://img.shields.io/badge/Buy%20me%20a-book-d13610?logo=buymeacoffee&logoColor=white)](https://buymeacoffee.com/sickn33) + +🌟 **21,000+ GitHub Stars Milestone！** 感谢社区将此项目转变为同类最大技能库之一！ + +**Antigravity Awesome Skills** 是一个精选、经过实战检验的**1,272+高性能代理技能**库，旨在与所有主要AI编码助手无缝协作： + +- 🟣 **Claude Code** (Anthropic CLI) +- 🔵 **Gemini CLI** (Google DeepMind) +- 🟢 **Codex CLI** (OpenAI) +- 🟠 **Kiro CLI** (AWS) +- 🟠 **Kiro IDE** (AWS) +- 🔴 **Antigravity IDE** (Google DeepMind) +- 🩵 **GitHub Copilot** (VSCode扩展) +- 🟠 **Cursor** (AI原生IDE) +- ⚪ **OpenCode** (开源CLI) +- 🌸 **AdaL CLI** (自我进化编码代理) + +此仓库提供了将您的AI助手转变为**全栈数字代理**的基本技能，包括来自**Anthropic**、**OpenAI**、**Google**、**Microsoft**、**Supabase**、**Apify**和**Vercel Labs**的官方功能。 + +## 目录 + +- [🚀 新手？从这里开始！](#新手从这里开始) +- [📖 完整使用指南](docs_zh-CN/USAGE.md) - **如果安装后感到困惑，从这里开始！** +- [🔌 兼容性与调用方式](#兼容性与调用方式) +- [🛠️ 安装](#安装) +- [🧯 故障排除](#故障排除) +- [🎁 精选集合（包）](#精选集合) +- [🧭 Antigravity工作流](#antigravity工作流) +- [📦 功能与分类](#功能与分类) +- [📚 浏览1,272+技能](#浏览1272技能) +- [🤝 如何贡献](#如何贡献) +- [💬 社区](#社区) +- [☕ 支持项目](#支持项目) +- [🏆 致谢与来源](#致谢与来源) +- [👥 仓库贡献者](#仓库贡献者) +- [⚖️ 许可证](#许可证) +- [🌟 Star历史](#star历史) + +--- + +## 新手？从这里开始！ + +**欢迎来到V7.1.0交互式网络版。**这不仅仅是一个脚本列表；它是您的AI代理的完整操作系统。 + +### 1. 🐣 背景：这是什么？ + +**Antigravity Awesome Skills** (Release 7.1.0) 是对AI能力的巨大升级。 + +AI代理（如Claude Code、Cursor或Gemini）很智能，但它们缺乏**特定工具**。它们不知道您公司的"部署协议"或"AWS CloudFormation"的特定语法。 +**技能**是小型markdown文件，可以教它们如何完美地完成这些特定任务，每次都如此。 + +### 2. ⚡️ 快速开始（1分钟） + +安装一次；然后使用[docs_zh-CN/BUNDLES.md](docs_zh-CN/BUNDLES.md)中的入门包来专注于您的角色。 + +1. **安装**： + + ```bash + # 默认：~/.gemini/antigravity/skills (Antigravity全局)。使用--path指定其他位置。 + npx antigravity-awesome-skills + ``` + +2. **验证**： + + ```bash + test -d ~/.gemini/antigravity/skills && echo "技能已安装在 ~/.gemini/antigravity/skills" + ``` + +3. **运行您的第一个技能**： + + > "使用**@brainstorming**来规划SaaS MVP。" + +4. **选择一个包**： + - **Web开发？**从`Web 向导`开始。 + - **安全？**从`Security Engineer`开始。 + - **通用使用？**从`基础`开始。 + +### 3. 🧠 如何使用 + +安装完成后，只需自然地询问您的代理： + +> "使用**@brainstorming**技能帮我规划SaaS。" +> "在这个文件上运行**@lint-and-validate**。" + +👉 **新功能：**[**完整使用指南 - 先读这个！**](docs_zh-CN/USAGE.md)（答案："安装后我该做什么？"、"我如何执行技能？"、"提示词应该是什么样的？"） + +👉 **[完整入门指南](docs_zh-CN/GETTING_STARTED.md)** + +--- + +## 兼容性与调用方式 + +这些技能遵循通用的**SKILL.md**格式，适用于任何支持代理技能的AI编码助手。 + +| 工具 | 类型 | 调用示例 | 路径 | +| :-------------- | :--- | :---------------------------- | :--------------------------------------------------------------------- | +| **Claude Code** | CLI | `>> /skill-name 帮我...` | `.claude/skills/` | +| **Gemini CLI** | CLI | `(用户提示) 使用skill-name...` | `.gemini/skills/` | +| **Codex CLI** | CLI | `(用户提示) 使用skill-name...` | `.codex/skills/` | +| **Kiro CLI** | CLI | `(自动) 按需加载技能` | 全局：`~/.kiro/skills/` · 工作区：`.kiro/skills/` | +| **Kiro IDE** | IDE | `/skill-name 或 (自动)` | 全局：`~/.kiro/skills/` · 工作区：`.kiro/skills/` | +| **Antigravity** | IDE | `(代理模式) 使用skill...` | 全局：`~/.gemini/antigravity/skills/` · 工作区：`.agent/skills/` | +| **Cursor** | IDE | `@skill-name (在聊天中)` | `.cursor/skills/` | +| **Copilot** | 扩展 | `(手动粘贴内容)` | 不适用用 | +| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` | +| **AdaL CLI** | CLI | `(自动) 按需加载技能` | `.adal/skills/` | + +> [!TIP] +> **默认安装路径**：`~/.gemini/antigravity/skills` (Antigravity全局)。使用`--path ~/.agent/skills`进行工作区特定安装。对于手动克隆，`.agent/skills/`可作为Antigravity的工作区路径。 +> **OpenCode路径更新**：opencode路径已更改为`.agents/skills`作为全局技能。请参见OpenCode文档上的[放置文件](https://opencode.ai/docs/skills/#place-files)指令。 + +> [!WARNING] +> **Windows用户**：此仓库为官方技能使用**符号链接**。 +> 有关确切的修复方法，请参见[故障排除](#故障排除)。 + +--- + +## 安装 + +要在**Claude Code**、**Gemini CLI**、**Codex CLI**、**Kiro CLI**、**Kiro IDE**、**Cursor**、**Antigravity**、**OpenCode**或**AdaL**中使用这些技能： + +### 选项A：npx（推荐） + +```bash +npx antigravity-awesome-skills + +# Antigravity（明确；与默认相同） +npx antigravity-awesome-skills --antigravity + +# Kiro CLI/IDE（全局） +npx antigravity-awesome-skills --path ~/.kiro/skills + +# Kiro CLI/IDE（工作区） +npx antigravity-awesome-skills --path .kiro/skills + +# Cursor +npx antigravity-awesome-skills --cursor + +# Claude Code +npx antigravity-awesome-skills --claude + +# Gemini CLI +npx antigravity-awesome-skills --gemini + +# Codex CLI +npx antigravity-awesome-skills --codex + +# Kiro CLI +npx antigravity-awesome-skills --kiro + +# OpenCode +npx antigravity-awesome-skills --path .agents/skills + +# AdaL CLI +npx antigravity-awesome-skills --path .adal/skills + +# 工作区特定（例如Antigravity工作区的.agent/skills） +npx antigravity-awesome-skills --path ~/.agent/skills + +# 自定义路径 +npx antigravity-awesome-skills --path ./my-skills +``` + +运行`npx antigravity-awesome-skills --help`查看所有选项。如果目录已存在，安装程序会运行`git pull`来更新。 + +### 选项B：git克隆 + +如果不使用`--path`，npx安装程序使用`~/.gemini/antigravity/skills`。对于手动克隆或不同路径（例如工作区`.agent/skills`），使用以下方法之一： + +```bash +# Antigravity全局（匹配npx默认） +git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.gemini/antigravity/skills + +# 工作区特定（例如项目中的.agent/skills） +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills + +# Kiro CLI/IDE全局 +git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills + +# Claude Code特定 +git clone https://github.com/sickn33/antigravity-awesome-skills.git .claude/skills + +# Gemini CLI特定 +git clone https://github.com/sickn33/antigravity-awesome-skills.git .gemini/skills + +# Codex CLI特定 +git clone https://github.com/sickn33/antigravity-awesome-skills.git .codex/skills + +# Cursor特定 +git clone https://github.com/sickn33/antigravity-awesome-skills.git .cursor/skills + +# OpenCode +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agents/skills + +# AdaL CLI特定 +git clone https://github.com/sickn33/antigravity-awesome-skills.git .adal/skills +``` + +### 选项C：Kiro IDE导入（GUI） + +对于Kiro IDE用户，您可以直接导入单个技能： + +1. 在Kiro IDE中打开**Agent Steering & Skills**面板 +2. 点击**+** → **导入技能** → **GitHub** +3. 粘贴技能URL：`https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/[skill-name]` +4. 示例：`https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-cost-optimizer` + +> **注意**：这一次只导入一个技能。对于批量安装，请使用上面的选项A或B。 + +--- + +## 故障排除 + +### `npx antigravity-awesome-skills`返回404 + +使用GitHub包回退： + +```bash +npx github:sickn33/antigravity-awesome-skills +``` + +### Windows克隆问题（符号链接） + +此仓库为官方技能使用符号链接。启用开发者模式或以管理员身份运行Git，然后使用以下方式克隆： + +```bash +git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +### 技能已安装但工具未检测到 + +安装到工具特定路径。使用安装程序标志：`--antigravity`（默认）、`--claude`、`--gemini`、`--codex`、`--cursor`或`--path `用于自定义位置（例如Antigravity工作区的`~/.agent/skills`）。 + +### 更新现有安装 + +**好消息！**您不再需要手动运行`git pull`或`npx antigravity-awesome-skills`来更新您的技能。 + +- **Windows：**双击**`START_APP.bat`**（或在终端中运行）。 +- **macOS/Linux：**从仓库根目录运行`cd web-app && npm run app:dev`。 + +两种方法每次打开Web应用时都会自动从原始仓库获取并合并最新技能，确保您始终拥有最新的目录。 + +### 从头重新安装 + +```bash +rm -rf ~/.gemini/antigravity/skills +npx antigravity-awesome-skills +``` + +--- + +## 精选集合 + +**包**是针对特定角色或目标（例如：`Web Wizard`、`Security Engineer`、`OSS Maintainer`）的精选技能组。 + +它们帮助您避免从950+技能中逐个选择。 + +### ⚠️ 重要：包不是单独的安装！ + +**常见困惑**："我需要单独安装每个包吗？" + +**答案：不需要！**以下是包的实际内容： + +**包是什么：** + +- ✅ 按角色组织的推荐技能列表 +- ✅ 帮助您决定使用什么的精选起点 +- ✅ 发现相关技能的省时快捷方式 + +**包不是什么：** + +- ❌ 单独的安装或下载 +- ❌ 不同的git命令 +- ❌ 需要您"激活"的东西 + +### 如何使用包： + +1. **安装仓库一次**（您已经拥有所有技能） +2. **浏览[docs_zh-CN/BUNDLES.md](docs_zh-CN/BUNDLES.md)中的包**来找到您的角色 +3. **从该包中选择3-5个技能**开始在提示中使用 +4. **在与AI的对话中引用它们**（例如，"使用@brainstorming..."） + +有关如何实际使用技能的详细示例，请参见[**使用指南**](docs_zh-CN/USAGE.md)。 + +### 示例： + +- 构建SaaS MVP：`Essentials` + `Full-Stack Developer` + `QA & Testing`。 +- 加固生产环境：`Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`。 +- 发布OSS变更：`Essentials` + `OSS Maintainer`。 + +## Antigravity工作流 + +包帮助您选择技能。工作流帮助您按顺序执行它们。 + +- 当您需要按角色获取推荐时使用包。 +- 当您需要为实现具体目标而逐步执行时使用工作流。 + +从这里开始： + +- [docs_zh-CN/WORKFLOWS.md](docs_zh-CN/WORKFLOWS.md)：人类可读的剧本。 +- [data/workflows.json](data/workflows.json)：机器可读的工作流元数据。 + +初始工作流包括： + +- 发布SaaS MVP +- Web应用安全审计 +- 构建AI代理系统 +- QA和浏览器自动化（可选的`@go-playwright`支持Go堆栈） + +## 功能与分类 + +仓库被组织成专业领域，将您的AI转变为整个软件开发生命周期的专家： + +| 分类 | 重点 | 示例技能 | +| :------------- | :------------------------------------------------- | :------------------------------------------------------------------------------ | +| 架构 | 系统设计、ADR、C4和可扩展模式 | `architecture`, `c4-context`, `senior-architect` | +| 商业 | 增长、定价、CRO、SEO和进入市场 | `copywriting`, `pricing-strategy`, `seo-audit` | +| 数据与AI | LLM应用、RAG、代理、可观测性、分析 | `rag-engineer`, `prompt-engineer`, `langgraph` | +| 开发 | 语言精通、框架模式、代码质量 | `typescript-expert`, `python-patterns`, `react-patterns` | +| 通用 | 规划、文档、产品运营、写作、指南 | `brainstorming`, `doc-coauthoring`, `writing-plans` | +| 基础设施 | DevOps、云、无服务器、部署、CI/CD | `docker-expert`, `aws-serverless`, `vercel-deployment` | +| 安全 | 应用安全、渗透测试、漏洞分析、合规 | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` | +| 测试 | TDD、测试设计、修复、QA工作流 | `test-driven-development`, `testing-patterns`, `test-fixing` | +| 工作流 | 自动化、编排、作业、代理 | `workflow-automation`, `inngest`, `trigger-dev` | + +计数随着新技能的添加而变化。有关当前完整注册表，请参见[CATALOG.md](CATALOG.md)。 + + +## 浏览1,272+技能 + +- 在[`apps/web-app`](apps/web-app)中打开交互式浏览器。 +- 阅读完整目录：[`CATALOG.md`](CATALOG.md)。 +- 从[`docs_zh-CN/users/bundles.md`](docs_zh-CN/users/bundles.md)中的基于角色的包开始。 +- 遵循[`docs_zh-CN/users/workflows.md`](docs_zh-CN/users/workflows.md)中以结果为导向的工作流。 +- 使用[`docs_zh-CN/users/getting-started.md`](docs_zh-CN/users/getting-started.md)和[`docs_zh-CN/users/usage.md`](docs_zh-CN/users/usage.md)中的入门指南。 + +## 文档 + +| 面向用户 | 面向贡献者 | 面向维护者 | +| ---------------------------------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | +| [`docs_zh-CN/users/getting-started.md`](docs_zh-CN/users/getting-started.md) | [`CONTRIBUTING.md`](CONTRIBUTING.md) | [`docs_zh-CN/maintainers/release-process.md`](docs_zh-CN/maintainers/release-process.md) | +| [`docs_zh-CN/users/usage.md`](docs_zh-CN/users/usage.md) | [`docs_zh-CN/contributors/skill-anatomy.md`](docs_zh-CN/contributors/skill-anatomy.md) | [`docs_zh-CN/maintainers/audit.md`](docs_zh-CN/maintainers/audit.md) | +| [`docs_zh-CN/users/faq.md`](docs_zh-CN/users/faq.md) | [`docs_zh-CN/contributors/quality-bar.md`](docs_zh-CN/contributors/quality-bar.md) | [`docs_zh-CN/maintainers/ci-drift-fix.md`](docs_zh-CN/maintainers/ci-drift-fix.md) | +| [`docs_zh-CN/users/visual-guide.md`](docs_zh-CN/users/visual-guide.md) | [`docs_zh-CN/contributors/examples.md`](docs_zh-CN/contributors/examples.md) | [`docs_zh-CN/maintainers/skills-update-guide.md`](docs_zh-CN/maintainers/skills-update-guide.md) | + +## Web应用 + +Web应用是导航如此大型仓库的最快方式。 + +**本地运行：** + +```bash +npm run app:install +npm run app:dev +``` + +这会将生成的技能索引复制到`apps/web-app/public/skills.json`，将当前的`skills/`目录树镜像到`apps/web-app/public/skills/`，并启动Vite开发服务器。 + +**在线托管：**相同的应用可在[https://sickn33.github.io/antigravity-awesome-skills/](https://sickn33.github.io/antigravity-awesome-skills/)获得，并在每次推送到`main`时自动部署。要启用一次：**Settings → Pages → Build and deployment → Source: GitHub Actions**。 + + + +## 贡献 + +- 在`skills//SKILL.md`下添加新技能。 +- 遵循[`CONTRIBUTING.md`](CONTRIBUTING.md)中的贡献者指南。 +- 使用[`docs_zh-CN/contributors/skill-template.md`](docs_zh-CN/contributors/skill-template.md)中的模板。 +- 在打开PR之前使用`npm run validate`进行验证。 + +## 社区 + +- [Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions)用于提问和反馈。 +- [Issues](https://github.com/sickn33/antigravity-awesome-skills/issues)用于错误报告和改进请求。 +- [`SECURITY.md`](SECURITY.md)用于安全报告。 + +--- + +## 支持项目 + +支持是可选的。这个项目对每个人保持免费和开源。 + +- [☕ 在Buy Me a Coffee上给原作者买本书](https://buymeacoffee.com/sickn33) +- Star仓库。 +- 提出清晰、可重现的问题。 +- 提交PR（技能、文档、修复）。 + +--- + +## 致谢与来源 + +我们站在巨人的肩膀上。 + +👉 **[查看完整归属账本](docs_zh-CN/SOURCES.md)** + +主要贡献者和来源包括： + +- **HackTricks** +- **OWASP** +- **Anthropic / OpenAI / Google** +- **开源社区** + +如果没有Claude Code社区和官方来源的不可思议工作，这个集合是不可能的： + +### 官方来源 + +- **[anthropics/skills](https://github.com/anthropics/skills)**：官方Anthropic技能仓库 - 文档操作（DOCX、PDF、PPTX、XLSX）、品牌指南、内部通信。 +- **[anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks)**：与Claude一起构建的官方笔记本和食谱。 +- **[remotion-dev/skills](https://github.com/remotion-dev/skills)**：官方Remotion技能 - React中视频创作，具有28个模块化规则。 +- **[vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)**：Vercel Labs官方技能 - React最佳实践、Web设计指南。 +- **[openai/skills](https://github.com/openai/skills)**：OpenAI Codex技能目录 - 代理技能、技能创建者、简洁规划。 +- **[supabase/agent-skills](https://github.com/supabase/agent-skills)**：Supabase官方技能 - Postgres最佳实践。 +- **[microsoft/skills](https://github.com/microsoft/skills)**：官方Microsoft技能 - Azure云服务、Bot Framework、认知服务，以及跨.NET、Python、TypeScript、Go、Rust和Java的企业开发模式。 +- **[google-gemini/gemini-skills](https://github.com/google-gemini/gemini-skills)**：官方Gemini技能 - Gemini API、SDK和模型交互。 +- **[apify/agent-skills](https://github.com/apify/agent-skills)**：官方Apify技能 - Web抓取、数据提取和自动化。 + +### 社区贡献者 + +- **[rmyndharis/antigravity-skills](https://github.com/rmyndharis/antigravity-skills)**：贡献了300+企业技能和目录生成逻辑。 +- **[amartelr/antigravity-workspace-manager](https://github.com/amartelr/antigravity-workspace-manager)**：官方工作区管理器CLI配套工具，用于跨无限本地开发环境动态自动配置技能子集。 +- **[obra/superpowers](https://github.com/obra/superpowers)**：Jesse Vincent的原始"Superpowers"。 +- **[guanyang/antigravity-skills](https://github.com/guanyang/antigravity-skills)**：核心Antigravity扩展。 +- **[diet103/claude-code-infrastructure-showcase](https://github.com/diet103/claude-code-infrastructure-showcase)**：基础设施和后端/前端指南。 +- **[ChrisWiles/claude-code-showcase](https://github.com/ChrisWiles/claude-code-showcase)**：React UI模式和设计系统。 +- **[travisvn/awesome-claude-skills](https://github.com/travisvn/awesome-claude-skills)**：Loki模式和Playwright集成。 +- **[zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide)**：综合安全套件和指南（约60个新技能的来源）。 +- **[alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)**：高级工程和PM工具包。 +- **[karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills)**：Claude Code的大量已验证技能列表。 +- **[VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)**：精选的61个高质量技能集合，包括来自Sentry、Trail of Bits、Expo、Hugging Face的官方团队技能和综合上下文工程套件（v4.3.0集成）。 +- **[zircote/.claude](https://github.com/zircote/.claude)**：Shopify开发技能参考。 +- **[vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills)**：AI代理、集成、制作工具（57个技能，Apache 2.0）。 +- **[coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)**：用于CRO、文案、SEO、付费广告和增长的营销技能（23个技能，MIT）。 +- **[Silverov/yandex-direct-skill](https://github.com/Silverov/yandex-direct-skill)**：Yandex Direct（API v5）广告审计技能 — 55个自动检查，A-F评分，俄罗斯PPC市场的活动/广告/关键词分析（MIT）。 +- **[vudovn/antigravity-kit](https://github.com/vudovn/antigravity-kit)**：AI代理模板，包含技能、代理和工作流（33个技能，MIT）。 +- **[affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)**：来自Anthropic黑客马拉松获胜者的完整Claude Code配置集合 - 仅技能（8个技能，MIT）。 +- **[whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills)**：TypeScript的实用fp-ts技能 – fp-ts-pragmatic、fp-ts-react、fp-ts-errors（v4.4.0）。 +- **[webzler/agentMemory](https://github.com/webzler/agentMemory)**：agent-memory-mcp技能的来源。 +- **[sstklen/claude-api-cost-optimization](https://github.com/sstklen/claude-api-cost-optimization)**：通过智能优化策略节省50-90%的Claude API成本（MIT）。 +- **[Wittlesus/cursorrules-pro](https://github.com/Wittlesus/cursorrules-pro)**：8个框架的专业.cursorrules配置 - Next.js、React、Python、Go、Rust等。适用于Cursor、Claude Code和Windsurf。 +- **[nedcodes-ok/rule-porter](https://github.com/nedcodes-ok/rule-porter)**：Cursor（.mdc）、Claude Code（CLAUDE.md）、GitHub Copilot、Windsurf和传统.cursorrules格式之间的双向规则转换器。零依赖。 +- **[SSOJet/skills](https://github.com/ssojet/skills)**：生产就绪的SSOJet技能和流行框架及平台的集成指南 — Node.js、Next.js、React、Java、.NET Core、Go、iOS、Android等。与SSOJet SAML、OIDC和企业SSO流无缝协作。适用于Cursor、Antigravity、Claude Code和Windsurf。 +- **[MojoAuth/skills](https://github.com/MojoAuth/skills)**：流行框架的生产就绪MojoAuth指南和示例，如Node.js、Next.js、React、Java、.NET Core、Go、iOS和Android。 +- **[Xquik-dev/x-twitter-scraper](https://github.com/Xquik-dev/x-twitter-scraper)**：X（Twitter）数据平台 — 推文搜索、用户查询、关注者提取、参与指标、赠品抽奖、监控、webhooks、19个提取工具、MCP服务器。 +- **[shmlkv/dna-claude-analysis](https://github.com/shmlkv/dna-claude-analysis)**：个人基因组分析工具包 — 分析原始DNA数据的Python脚本，跨越17个类别（健康风险、祖先、药物基因组学、营养、心理学等），具有终端风格的单页HTML可视化。 +- **[AlmogBaku/debug-skill](https://github.com/AlmogBaku/debug-skill)**: Interactive debugger skill for AI agents — breakpoints, stepping, variable inspection, and stack traces via the `dap` CLI. Supports Python, Go, Node.js/TypeScript, Rust, and C/C++. + +### 灵感来源 +- **[f/awesome-chatgpt-prompts](https://github.com/f/awesome-chatgpt-prompts)**：提示库的灵感。 +- **[leonardomso/33-js-concepts](https://github.com/leonardomso/33-js-concepts)**：JavaScript精通的灵感。 +### 其他来源 +- **[agent-cards/skill](https://github.com/agent-cards/skill)**：为AI代理管理预付虚拟Visa卡。创建卡片、检查余额、查看凭证、关闭卡片，并通过MCP工具获取支持。 +--- + +## 仓库贡献者 + + + Repository contributors + + +使用[contrib.rocks](https://contrib.rocks)制作。 + +我们正式感谢以下贡献者帮助使这个仓库变得精彩！ + +- [@sickn33](https://github.com/sickn33) +- [@munir-abbasi](https://github.com/munir-abbasi) +- [@ssumanbiswas](https://github.com/ssumanbiswas) +- [@zinzied](https://github.com/zinzied) +- [@Mohammad-Faiz-Cloud-Engineer](https://github.com/Mohammad-Faiz-Cloud-Engineer) +- [@Dokhacgiakhoa](https://github.com/Dokhacgiakhoa) +- [@IanJ332](https://github.com/IanJ332) +- [@chauey](https://github.com/chauey) +- [@ar27111994](https://github.com/ar27111994) +- [@8hrsk](https://github.com/8hrsk) +- [@itsmeares](https://github.com/itsmeares) +- [@GuppyTheCat](https://github.com/GuppyTheCat) +- [@fernandorych](https://github.com/fernandorych) +- [@nikolasdehor](https://github.com/nikolasdehor) +- [@talesperito](https://github.com/talesperito) +- [@jackjin1997](https://github.com/jackjin1997) +- [@HuynhNhatKhanh](https://github.com/HuynhNhatKhanh) +- [@liyin2015](https://github.com/liyin2015) +- [@arathiesh](https://github.com/arathiesh) +- [@Tiger-Foxx](https://github.com/Tiger-Foxx) +- [@Musayrlsms](https://github.com/Musayrlsms) +- [@sohamganatra](https://github.com/sohamganatra) +- [@SuperJMN](https://github.com/SuperJMN) +- [@SebConejo](https://github.com/SebConejo) +- [@Onsraa](https://github.com/Onsraa) +- [@truongnmt](https://github.com/truongnmt) +- [@code-vj](https://github.com/code-vj) +- [@viktor-ferenczi](https://github.com/viktor-ferenczi) +- [@vprudnikoff](https://github.com/vprudnikoff) +- [@Vonfry](https://github.com/Vonfry) +- [@Wittlesus](https://github.com/Wittlesus) +- [@avimak](https://github.com/avimak) +- [@buzzbysolcex](https://github.com/buzzbysolcex) +- [@c1c3ru](https://github.com/c1c3ru) +- [@ckdwns9121](https://github.com/ckdwns9121) +- [@developer-victor](https://github.com/developer-victor) +- [@fbientrigo](https://github.com/fbientrigo) +- [@junited31](https://github.com/junited31) +- [@KrisnaSantosa15](https://github.com/KrisnaSantosa15) +- [@nocodemf](https://github.com/nocodemf) +- [@sstklen](https://github.com/sstklen) +- [@taksrules](https://github.com/taksrules) +- [@thuanlm215](https://github.com/thuanlm215) +- [@zebbern](https://github.com/zebbern) +- [@vuth-dogo](https://github.com/vuth-dogo) +- [@ALEKGG1](https://github.com/ALEKGG1) +- [@Abdulrahmansoliman](https://github.com/Abdulrahmansoliman) +- [@alexmvie](https://github.com/alexmvie) +- [@Andruia](https://github.com/Andruia) +- [@acbhatt12](https://github.com/acbhatt12) +- [@BenedictKing](https://github.com/BenedictKing) +- [@rcigor](https://github.com/rcigor) +- [@whatiskadudoing](https://github.com/whatiskadudoing) +- [@k-kolomeitsev](https://github.com/k-kolomeitsev) +- [@Krishna-Modi12](https://github.com/Krishna-Modi12) +- [@kromahlusenii-ops](https://github.com/kromahlusenii-ops) +- [@djmahe4](https://github.com/djmahe4) +- [@maxdml](https://github.com/maxdml) +- [@mertbaskurt](https://github.com/mertbaskurt) +- [@nedcodes-ok](https://github.com/nedcodes-ok) +- [@LocNguyenSGU](https://github.com/LocNguyenSGU) +- [@KhaiTrang1995](https://github.com/KhaiTrang1995) +- [@sharmanilay](https://github.com/sharmanilay) +- [@yubing744](https://github.com/yubing744) +- [@PabloASMD](https://github.com/PabloASMD) +- [@0xrohitgarg](https://github.com/0xrohitgarg) +- [@Silverov](https://github.com/Silverov) +- [@shmlkv](https://github.com/shmlkv) +- [@kriptoburak](https://github.com/kriptoburak) + +--- + +## 许可证 + +MIT许可证。详细信息请参见[LICENSE](LICENSE)。 + +--- + +## Star历史 + +[![Star History Chart](https://api.star-history.com/svg?repos=sickn33/antigravity-awesome-skills&type=date&legend=top-left)](https://www.star-history.com/#sickn33/antigravity-awesome-skills&type=date&legend=top-left) + +如果Antigravity Awesome Skills对您有用，请考虑⭐给仓库加星！ + + diff --git a/docs_zh-CN/README.md b/docs_zh-CN/README.md new file mode 100644 index 00000000..088e881b --- /dev/null +++ b/docs_zh-CN/README.md @@ -0,0 +1,39 @@ +# 文档索引 + +## 用户文档 + +- [`users/getting-started.md`](users/getting-started.md) - 入门指南 +- [`users/usage.md`](users/usage.md) - 使用指南 +- [`users/faq.md`](users/faq.md) - 常见问题 +- [`users/bundles.md`](users/bundles.md) - 技能包 +- [`users/workflows.md`](users/workflows.md) - 工作流 +- [`users/kiro-integration.md`](users/kiro-integration.md) - Kiro集成 +- [`users/visual-guide.md`](users/visual-guide.md) - 可视化指南 +- [`users/local-config.md`](users/local-config.md) - 本地配置 + +## 贡献者文档 + +- [`../CONTRIBUTING.md`](../CONTRIBUTING.md) - 贡献指南 +- [`contributors/skill-template.md`](contributors/skill-template.md) - 技能模板 +- [`contributors/skill-anatomy.md`](contributors/skill-anatomy.md) - 技能结构 +- [`contributors/examples.md`](contributors/examples.md) - 示例 +- [`contributors/quality-bar.md`](contributors/quality-bar.md) - 质量标准 +- [`contributors/security-guardrails.md`](contributors/security-guardrails.md) - 安全护栏 +- [`contributors/community-guidelines.md`](contributors/community-guidelines.md) - 社区准则 + +## 维护者文档 + +- [`maintainers/release-process.md`](maintainers/release-process.md) - 发布流程 +- [`maintainers/rollback-procedure.md`](maintainers/rollback-procedure.md) - 回滚程序 +- [`maintainers/audit.md`](maintainers/audit.md) - 审计 +- [`maintainers/ci-drift-fix.md`](maintainers/ci-drift-fix.md) - CI漂移修复 +- [`maintainers/skills-update-guide.md`](maintainers/skills-update-guide.md) - 技能更新指南 +- [`maintainers/categorization-implementation.md`](maintainers/categorization-implementation.md) - 分类实现 +- [`maintainers/date-tracking-implementation.md`](maintainers/date-tracking-implementation.md) - 日期跟踪实现 +- [`maintainers/skills-date-tracking.md`](maintainers/skills-date-tracking.md) - 技能日期跟踪 + +## 源文档 + +- [`sources/sources.md`](sources/sources.md) - 来源说明 +- [`sources/LICENSE-MICROSOFT`](sources/LICENSE-MICROSOFT) - Microsoft许可证 +- [`sources/microsoft-skills-attribution.json`](sources/microsoft-skills-attribution.json) - Microsoft技能归属 \ No newline at end of file diff --git a/docs_zh-CN/contributors/community-guidelines.md b/docs_zh-CN/contributors/community-guidelines.md new file mode 100644 index 00000000..c28cf2c9 --- /dev/null +++ b/docs_zh-CN/contributors/community-guidelines.md @@ -0,0 +1,261 @@ +# 行为准则 + +## 我们的承诺 + +为了营造开放和友好的环境，我们作为贡献者和维护者承诺，让每个人在参与我们的项目和社区时都能获得无骚扰的体验。 + +## 我们的标准 + +以下行为有助于创造积极环境： + +- 使用热情和包容的语言 +- 尊重不同的观点和经验 +- 优雅地接受建设性批评 +- 关注对社区最有利的方面 +- 对其他社区成员表示同理心 + +参与者不可接受的行为包括： + +- 使用性化语言或图像，以及不受欢迎的性关注或示好 +- 恶意挑衅、侮辱/贬低性评论，以及人身或政治攻击 +- 公开或私下骚扰 +- 未经明确许可发布他人隐私信息 +- 其他在专业环境中可能被认为不当的行为 + +## 执行 + +项目维护者负责明确可接受行为的标准，并预期对任何不可接受行为的实例采取适当和公平的纠正措施。 + +## 归属 + +本行为准则改编自[Contributor Covenant](https://www.contributor-covenant.org)，版本2.1，可在[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html)查看完整版本。 + +## 联系信息 + +如有行为准则相关问题，请联系： + +- 📧 conduct@antigravity-skills.org +- 🐛 [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues) +- 💬 [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions) + +--- + +## 报告指南 + +如果您遇到或目睹了不当行为，请按以下步骤报告： + +### 1. 立即报告 +- 发送邮件至：conduct@antigravity-skills.org +- 或创建GitHub Issue，标签：`conduct-report` + +### 2. 报告内容 +请包含以下信息： +- 发生时间 +- 相关人员 +- 具体行为描述 +- 任何相关截图或证据 + +### 3. 处理流程 +我们承诺： +- 24小时内确认收到报告 +- 48小时内开始调查 +- 保护报告者隐私 +- 公平公正处理 + +--- + +## 社区价值观 + +### 🤝 包容性 +我们欢迎所有背景的贡献者，无论： +- 经验水平 +- 技术专长 +- 地理位置 +- 身份认同 +- 语言能力 + +### 🌱 成长型思维 +我们相信： +- 每个人都能学习和改进 +- 提问是学习的开始 +- 失败是成长的机会 +- 反馈促进进步 + +### 🎯 质量优先 +我们致力于： +- 高质量的技能和文档 +- 彻底的测试和验证 +- 持续改进和创新 +- 用户体验优先 + +### 🤝 协作精神 +我们鼓励： +- 互相帮助和支持 +- 知识分享和传承 +- 建设性反馈和讨论 +- 团队合作和共赢 + +--- + +## 贡献类型 + +我们欢迎多种形式的贡献： + +### 💻 代码贡献 +- 新技能开发 +- 现有技能改进 +- 工具和脚本开发 +- 测试用例编写 + +### 📚 文档贡献 +- 中文翻译 +- 文档改进 +- 示例和教程 +- 用户指南编写 + +### 🐛 问题报告 +- Bug报告 +- 功能建议 +- 安全漏洞报告 +- 用户体验反馈 + +### 🎨 设计贡献 +- UI/UX改进 +- 视觉设计 +- 品牌设计 +- 图标和插图 + +### 📢 社区贡献 +- 用户支持 +- 活动组织 +- 知识分享 +- 推广宣传 + +--- + +## 沟通渠道 + +### 主要渠道 +- 📋 [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 一般讨论 +- 🐛 [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues) - 技术问题 +- 📧 [邮件列表](mailto:dev@antigravity-skills.org) - 开发讨论 + +### 社交媒体 +- 🐦 [Twitter](https://twitter.com/antigravity_ai) - 项目动态 +- 💬 [Discord](https://discord.gg/antigravity) - 实时聊天 +- 📺 [YouTube](https://youtube.com/c/antigravity) - 教程和演示 + +### 本地社区 +- 🌍 [本地聚会](https://meetup.com/antigravity-skills) - 线下交流 +- 🎓 [学习小组](https://study-groups.antigravity-skills.org) - 协作学习 +- 👥 [贡献者聚会](https://contributors.antigravity-skills.org) - 定期交流 + +--- + +## 期望与回报 + +### 我们期望您 +- 🎯 **积极参与** - 不仅仅是旁观者 +- 🤝 **互相尊重** - 建设性交流 +- 📚 **持续学习** - 保持开放心态 +- 🌱 **帮助他人** - 分享您所知 +- 🎨 **追求卓越** - 高标准工作 + +### 您将获得 +- 🏆 **社区认可** - 贡献者展示 +- 📈 **技能提升** - 实践和学习机会 +- 🌐 **全球网络** - 与全球专家连接 +- 🎁 **专属资源** - 提前访问新功能 +- 🎯 **职业发展** - 建立专业声誉 + +--- + +## 冲突解决 + +### 小分歧 +当遇到小分歧时： +1. **私下沟通** - 直接与相关人员联系 +2. **理解对方** - 倾听不同观点 +3. **寻求共识** - 找到双方同意的解决方案 +4. **向前看** - 专注于项目目标 + +### 严重问题 +当遇到严重问题时： +1. **联系维护者** - 通过官方渠道报告 +2. **提供证据** - 具体事实和时间线 +3. **保持专业** - 避免情绪化语言 +4. **信任流程** - 让维护者处理 + +### 申诉流程 +如果您对处理结果不满意： +1. **书面申诉** - 发送邮件至appeals@antigravity-skills.org +2. **包含详情** - 原始问题和处理结果 +3. **说明理由** - 为什么认为处理不当 +4. **等待审查** - 委员会将在7天内回复 + +--- + +## 特殊考虑 + +### 新贡献者 +我们特别关注新贡献者： +- 🌱 **导师制度** - 一对一指导 +- 📋 **新人友好问题** - 标记简单任务 +- 🎯 **循序渐进** - 从简单到复杂 +- 🏆 **新人表彰** - 肯定第一次贡献 + +### 多元化与包容性 +我们积极促进多元化： +- 🌍 **地理包容** - 支持全球时区 +- 🌐 **语言包容** - 多语言支持 +- 👥 **背景包容** - 欢迎各种背景 +- ♿ **无障碍** - 确保平等参与 + +### 学术和研究 +我们支持学术研究： +- 📊 **数据访问** - 提供研究数据 +- 📝 **论文支持** - 协助学术写作 +- 🎓 **合作研究** - 共同开展研究 +- 🏛️ **学术认可** - 承认学术贡献 + +--- + +## 持续改进 + +我们承诺持续改进社区环境： + +### 定期评估 +- 📋 **季度调查** - 收集反馈 +- 📊 **指标追踪** - 监控社区健康 +- 🎯 **目标设定** - 制定改进计划 +- 📈 **成果报告** - 透明分享进展 + +### 社区治理 +- 🏛️ **治理结构** - 明确决策流程 +- 📜 **制度完善** - 定期更新规则 +- 👥 **委员会** - 成立专门工作组 +- 🗳 **民主参与** - 社区投票决策 + +--- + +## 致谢 + +感谢所有为这个社区做出贡献的人。正是因为您的参与，这个项目才能持续发展和改进。 + +### 特别感谢 +- 🏆 **核心贡献者** - 长期维护项目的成员 +- 🌟 **新星贡献者** - 活跃的新参与者 +- 🤝 **社区建设者** - 帮助社区成长的志愿者 +- 📚 **知识分享者** - 撰写教程和文档的朋友 + +--- + +## 结语 + +这个行为准则是我们的承诺，致力于创造一个让每个人都感到受欢迎、被尊重和能够充分发挥潜力的环境。 + +让我们一起建设一个更好的社区！🚀 + +如果您有任何问题、建议或关注，请不要犹豫联系我们。 + +**感谢您成为我们社区的一员！** 🌟 \ No newline at end of file diff --git a/docs_zh-CN/contributors/examples.md b/docs_zh-CN/contributors/examples.md new file mode 100644 index 00000000..d061e5cd --- /dev/null +++ b/docs_zh-CN/contributors/examples.md @@ -0,0 +1,755 @@ +# 💡 实际示例 - 查看技能的实际应用 + +**通过示例学习！**本指南向您展示使用不同技能的真实对话。 + +--- + +## 示例 1：使用 @brainstorming 设计功能 + +### 场景 +您想为您的应用添加"暗黑模式"功能，但不确定如何实现。 + +### 对话 + +``` +您：@brainstorming 我想为我的 React 应用添加暗黑模式 + +AI：太好了！让我帮您思考这个方案。首先，让我检查您当前的 + 项目结构... + + [AI 检查您的文件] + + 我看到您正在使用 React 和 Tailwind CSS。现在，让我们了解 + 您的需求： + + 暗黑模式的主要目标是什么？ + a) 用户偏好（在设置中切换） + b) 系统偏好（跟随操作系统设置） + c) 两者都有（可手动覆盖） + +您：c) 两者都有 + +AI：完美！这是最佳用户体验。下一个问题： + + 暗黑模式切换按钮应该放在哪里？ + a) 在主导航中 + b) 在设置页面中 + c) 在下拉菜单中 + d) 多个位置 + +您：a) 在主导航中 + +AI：很好的可访问性选择。还有一个问题： + + 暗黑模式偏好是否应该跨会话保持？ + a) 是的，保存到 localStorage + b) 是的，保存到用户账户（需要后端） + c) 不，每次会话重置 + +您：a) 是的，保存到 localStorage + +AI：太好了！现在我有了清晰的图景。让我展示设计方案... + + ## 暗黑模式实现设计 + + ### 架构概述 + 我们将使用 React Context 进行状态管理，Tailwind 的暗黑模式 + 工具，以及 localStorage 进行持久化。系统将： + 1. 首次访问时检查操作系统偏好 + 2. 允许通过切换按钮手动覆盖 + 3. 在 localStorage 中保存偏好 + + 这个方法看起来可以吗？ + +您：可以，继续 + +AI：[继续详细的设计部分...] + + [设计完成后] + + 我已将设计保存到 docs/plans/2026-01-20-dark-mode-design.md + + 准备好开始实施了吗？ + +您：是的 + +AI：我将使用 git worktrees 创建一个独立的工作区并编写 + 实施计划。稍等... +``` + +### 发生了什么 +- ✅ AI 一次问一个有针对性的问题 +- ✅ 探索了您的具体上下文 +- ✅ 分部分展示设计 +- ✅ 保存文档 +- ✅ 准备实施 + +--- + +## 示例 2：使用 @systematic-debugging 调试 + +### 场景 +您的测试失败了，但不知道为什么。 + +### 对话 + +``` +您：@systematic-debugging 我的测试失败了，提示"Cannot read property + 'map' of undefined" + +AI：让我帮您系统地调试这个问题。首先，我会收集信息： + + 1. 运行失败的测试以查看完整错误... + + [AI 运行：npm test] + + 我看到错误发生在 UserList.test.tsx 的第 45 行。让我检查 + 测试文件和组件... + + [AI 读取两个文件] + + ## 假设 + 测试失败是因为 `users` 属性在组件渲染时未定义。这表明 + mock 数据没有正确传递。 + + ## 验证 + 让我检查测试设置... + + [AI 检查测试] + + 找到了！测试调用的是： + ```typescript + render() + ``` + + 但 UserList 需要一个 `users` 属性。组件期望： + ```typescript + interface UserListProps { + users: User[]; + } + ``` + + ## 解决方案 + 测试应该传递 users 属性： + ```typescript + const mockUsers = [ + { id: 1, name: 'Alice' }, + { id: 2, name: 'Bob' } + ]; + + render() + ``` + + 我应该应用这个修复吗？ + +您：是的 + +AI：[应用修复并运行测试] + + ✅ 所有测试通过！ + + ## 根本原因 + 测试缺少必需的属性。这是组件被重构为需要以前可选属性时 + 的常见问题。 + + ## 预防 + 考虑添加 TypeScript 严格模式以在编译时捕获这些问题： + ```json + "strict": true, + "strictNullChecks": true + ``` + + 您想让我将此添加到您的 tsconfig.json 吗？ +``` + +### 发生了什么 +- ✅ 系统性调查 +- ✅ 清晰的假设 +- ✅ 修复前验证 +- ✅ 根本原因分析 +- ✅ 预防建议 + +--- + +## 示例 3：使用 @stripe-integration 添加支付功能 + +### 场景 +您需要为 SaaS 应用添加订阅计费功能。 + +### 对话 + +``` +您：@stripe-integration 我需要添加月度订阅计费 + +AI：我会帮您实现 Stripe 订阅。让我了解您的需求： + + 检测到的当前技术栈： + - Next.js 14（App Router） + - TypeScript + - Prisma 和 PostgreSQL + + 对于订阅计费，我们需要： + + 1. **Stripe 设置** + - Stripe 账户和 API 密钥 + - 事件的 webhook 端点 + - 产品和价格 ID + + 2. **后端实现** + - 结账的 API 路由 + - Webhook 处理程序 + - 订阅的数据库架构 + + 3. **前端实现** + - 定价页面 + - 结账流程 + - 订阅管理 + + 让我们从后端开始。首先，安装依赖项： + + ```bash + npm install stripe @stripe/stripe-js + ``` + + 现在，让我们创建数据库架构... + + [AI 提供 Prisma 架构] + + ```prisma + model User { + id String @id @default(cuid()) + email String @unique + stripeCustomerId String? @unique + subscriptions Subscription[] + } + + model Subscription { + id String @id @default(cuid()) + userId String + user User @relation(fields: [userId], references: [id]) + stripeSubscriptionId String @unique + status String + priceId String + currentPeriodEnd DateTime + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + } + ``` + + 接下来，让我们创建结账 API 路由... + + [AI 提供完整的实现，包括：] + - 创建结账会话的 API 路由 + - 订阅事件的 webhook 处理程序 + - Stripe 操作的辅助函数 + - 错误处理和日志记录 + - TypeScript 类型 + + 现在是前端... + + [AI 提供：] + - 定价页面组件 + - 结账按钮组件 + - 订阅状态显示 + - Tailwind 样式 + + 最后，让我们设置 webhook： + + 1. 在 Stripe Dashboard 中，添加 webhook 端点： + `https://yourdomain.com/api/webhooks/stripe` + + 2. 选择这些事件： + - customer.subscription.created + - customer.subscription.updated + - customer.subscription.deleted + - invoice.payment_succeeded + - invoice.payment_failed + + 3. 将 webhook 密钥复制到您的 .env： + ``` + STRIPE_WEBHOOK_SECRET=whsec_... + ``` + + ## 测试 + + 使用 Stripe CLI 在本地测试： + ```bash + stripe listen --forward-to localhost:3000/api/webhooks/stripe + stripe trigger customer.subscription.created + ``` + + ## 安全检查清单 + - ✅ 环境变量中的 API 密钥 + - ✅ Webhook 签名验证 + - ✅ 服务器端价格验证 + - ✅ 操作的幂等性密钥 + + 准备好测试实现了吗？ +``` + +### 发生了什么 +- ✅ 检测到现有技术栈 +- ✅ 提供完整实现 +- ✅ 包含数据库架构 +- ✅ 添加安全最佳实践 +- ✅ 包含测试说明 + +--- + +## 示例 4：使用 @copywriting 撰写文案 + +### 场景 +您需要为 SaaS 落地页撰写有吸引力的文案。 + +### 对话 + +``` +您：@copywriting 为我的项目管理工具撰写主页文案 + +AI：我会帮您创建有吸引力的主页文案。首先，让我了解您的产品： + + 您的项目管理工具与 Asana、Trello 或 Monday.com 等竞争对手相比 + 有什么不同之处？ + +您：它专为远程团队构建，内置视频站会和异步通信功能 + +AI：优秀的差异化！谁是您的目标受众？ + a) 初创公司和小团队（2-20 人） + b) 中型公司（20-200 人） + c) 企业（200+ 人） + d) 自由职业者和代理商 + +您：a) 初创公司和小团队 + +AI：完美。您解决的主要痛点是什么？ + +您：远程团队在不必要的会议中浪费时间，在异步通信中丢失上下文 + +AI：太好了！现在我有了所需的信息。这是您的主页文案： + + --- + + ## 英雄区块 + + **标题：** + 在无会议过载的情况下运行您的远程团队 + + **副标题：** + 专为分布式团队构建的项目管理工具。用异步视频站会替代 + 状态会议，让所有人保持同步，而无需 Zoom 疲劳。 + + **行动号召：** + 开始免费试用 → （无需信用卡） + + --- + + ## 问题区块 + + **标题：** + 远程工作不应意味着更多会议 + + **正文：** + 您的团队分布在不同的时区。您花费数小时在状态会议上 + 仅为了保持一致。异步更新在 Slack 中丢失。 + 上下文消失。生产力下降。 + + 听起来很熟悉？ + + --- + + ## 解决方案区块 + + **标题：** + 无会议马拉松即可保持一致 + + **功能：** + + 📹 **异步视频站会** + 按您的计划录制快速视频更新。您的团队在适合他们的时间观看。 + 不再为东京的队友在上午 9 点打电话。 + + 💬 **上下文丰富的通信** + 每个任务、评论和决策都保持连接。不再在 Slack 线程或 + 电子邮件链中寻找。 + + 📊 **可视化进度跟踪** + 一目了然地查看正在发生的事情。看板、时间线和 + 实际上有意义的仪表板。 + + 🔔 **智能通知** + 获得关于重要事项的通知。忽略其余的。您的专注时间是 + 神圣的。 + + --- + + ## 社会证明区块 + + **标题：** + 受全球远程团队信赖 + + [带有结构的推荐占位符] + + --- + + ## 行动号召区块 + + **标题：** + 准备好重新掌控您的日历了吗？ + + **正文：** + 加入 500 多个远程团队，他们将会议时间减少了 60%，同时 + 保持前所未有的高度一致。 + + **行动号召：** + 开始您的 14 天免费试用 → + + 无需信用卡。随时取消。 + + --- + + ## 文案说明 + + **语气：** 专业但对话式 + **重点：** 痛点（太多会议）→ 解决方案（异步视频） + **差异化：** 专为远程团队构建 + **社会证明：** 量化利益（减少 60% 的会议） + + 您想让我： + 1. 撰写替代版本用于 A/B 测试？ + 2. 为特定功能页面撰写文案？ + 3. 撰写用于入门的电子邮件序列？ +``` + +### 发生了什么 +- ✅ 询问了澄清性问题 +- ✅ 确定了独特的价值主张 +- ✅ 创建了以利益为重点的文案 +- ✅ 包含了清晰的行动号召 +- ✅ 提供了一致性的文案说明 + +--- + +## 示例 5：使用 @test-driven-development 进行测试驱动开发 + +### 场景 +您需要实现一个新功能：用户身份验证。 + +### 对话 + +``` +您：@test-driven-development 我需要实现用户登录功能 + +AI：完美！让我们使用 TDD 来构建这个。遵循红-绿-重构 + 周期，我们将先编写测试，然后实现。 + + ## 步骤 1：编写第一个测试（红色） + + 让我们从最简单的情况开始 - 成功登录： + + ```typescript + // auth.test.ts + import { login } from './auth'; + + describe('login', () => { + it('should return user data for valid credentials', async () => { + const result = await login({ + email: 'user@example.com', + password: 'correct-password' + }); + + expect(result.success).toBe(true); + expect(result.user).toHaveProperty('id'); + expect(result.user).toHaveProperty('email'); + expect(result.token).toBeDefined(); + }); + }); + ``` + + 让我们运行这个测试以看到它失败： + + [AI 运行：npm test] + + ✅ 测试按预期失败（auth.ts 尚不存在） + + ## 步骤 2：编写最小实现（绿色） + + 现在让我们编写足够的代码以使此测试通过： + + ```typescript + // auth.ts + interface LoginCredentials { + email: string; + password: string; + } + + interface LoginResult { + success: boolean; + user?: { + id: string; + email: string; + }; + token?: string; + } + + export async function login( + credentials: LoginCredentials + ): Promise { + // 使测试通过的最小实现 + return { + success: true, + user: { + id: '1', + email: credentials.email + }, + token: 'fake-token' + }; + } + ``` + + [AI 运行：npm test] + + ✅ 测试通过！ + + ## 步骤 3：添加下一个测试（红色） + + 现在让我们测试失败情况： + + ```typescript + it('should return error for invalid credentials', async () => { + const result = await login({ + email: 'user@example.com', + password: 'wrong-password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Invalid credentials'); + expect(result.user).toBeUndefined(); + expect(result.token).toBeUndefined(); + }); + ``` + + [AI 运行：npm test] + + ❌ 测试失败（总是返回成功） + + ## 步骤 4：实现真实逻辑（绿色） + + 现在让我们添加实际的身份验证： + + ```typescript + import bcrypt from 'bcrypt'; + import jwt from 'jsonwebtoken'; + import { db } from './db'; + + export async function login( + credentials: LoginCredentials + ): Promise { + // 查找用户 + const user = await db.user.findUnique({ + where: { email: credentials.email } + }); + + if (!user) { + return { + success: false, + error: 'Invalid credentials' + }; + } + + // 验证密码 + const validPassword = await bcrypt.compare( + credentials.password, + user.passwordHash + ); + + if (!validPassword) { + return { + success: false, + error: 'Invalid credentials' + }; + } + + // 生成令牌 + const token = jwt.sign( + { userId: user.id }, + process.env.JWT_SECRET!, + { expiresIn: '7d' } + ); + + return { + success: true, + user: { + id: user.id, + email: user.email + }, + token + }; + } + ``` + + [AI 运行：npm test] + + ✅ 所有测试通过！ + + ## 步骤 5：添加边缘情况 + + 让我们为边缘情况添加更多测试： + + ```typescript + it('should handle missing email', async () => { + const result = await login({ + email: '', + password: 'password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Email is required'); + }); + + it('should handle missing password', async () => { + const result = await login({ + email: 'user@example.com', + password: '' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Password is required'); + }); + + it('should handle database errors gracefully', async () => { + // 模拟数据库错误 + jest.spyOn(db.user, 'findUnique').mockRejectedValue( + new Error('Database connection failed') + ); + + const result = await login({ + email: 'user@example.com', + password: 'password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('An error occurred'); + }); + ``` + + [AI 实现验证和错误处理] + + ## 步骤 6：重构（重构） + + 现在所有测试都通过了，让我们为了更好的代码质量进行重构： + + ```typescript + // 提取验证 + function validateCredentials(credentials: LoginCredentials): string | null { + if (!credentials.email) return 'Email is required'; + if (!credentials.password) return 'Password is required'; + return null; + } + + // 提取用户验证 + async function verifyUser( + email: string, + password: string + ): Promise { + const user = await db.user.findUnique({ where: { email } }); + if (!user) return null; + + const valid = await bcrypt.compare(password, user.passwordHash); + return valid ? user : null; + } + + // 主函数现在更清晰 + export async function login( + credentials: LoginCredentials + ): Promise { + try { + const validationError = validateCredentials(credentials); + if (validationError) { + return { success: false, error: validationError }; + } + + const user = await verifyUser( + credentials.email, + credentials.password + ); + + if (!user) { + return { success: false, error: 'Invalid credentials' }; + } + + const token = generateToken(user.id); + + return { + success: true, + user: { id: user.id, email: user.email }, + token + }; + } catch (error) { + console.error('Login error:', error); + return { success: false, error: 'An error occurred' }; + } + } + ``` + + [AI 运行：npm test] + + ✅ 重构后所有测试仍然通过！ + + ## 总结 + + 我们使用 TDD 实现了登录功能： + - ✅ 5 个测试覆盖正常路径、错误和边缘情况 + - ✅ 干净、可测试的代码 + - ✅ 适当的错误处理 + - ✅ TypeScript 类型安全 + + 下一步： + 1. 添加速率限制测试 + 2. 添加会话管理测试 + 3. 添加登出功能 + + 我应该继续这些吗？ +``` + +### 发生了什么 +- ✅ 遵循红-绿-重构周期 +- ✅ 在实现之前编写测试 +- ✅ 覆盖边缘情况 +- ✅ 有信心地重构 +- ✅ 保持测试覆盖率 + +--- + +## 主要收获 + +### 使这些示例有效的原因是什么？ + +1. **技能在跳转到解决方案之前会询问澄清性问题** +2. **技能根据您的项目提供上下文相关的帮助** +3. **技能遵循其领域的最佳实践** +4. **技能包括完整的示例，而不仅仅是片段** +5. **技能解释"为什么"，而不仅仅是"如何"** + +### 如何获得类似的结果 + +1. **具体说明**您的请求 +2. **提供上下文**关于您的项目 +3. **回答**技能提出的问题 +4. **在应用之前审查**建议 +5. **根据结果迭代** + +--- + +## 自己尝试这些！ + +选择一个技能并用自己的项目尝试： + +- **规划：** `@brainstorming` 或 `@writing-plans` +- **开发：** `@test-driven-development` 或 `@react-best-practices` +- **调试：** `@systematic-debugging` 或 `@test-fixing` +- **集成：** `@stripe-integration` 或 `@firebase` +- **营销：** `@copywriting` 或 `@seo-audit` + +--- + +**想要更多示例？**查看各个技能文件夹以获取其他示例和用例！ diff --git a/docs_zh-CN/contributors/skill-template.md b/docs_zh-CN/contributors/skill-template.md new file mode 100644 index 00000000..1d18efe3 --- /dev/null +++ b/docs_zh-CN/contributors/skill-template.md @@ -0,0 +1,292 @@ +--- +name: your-skill-name +description: "简要一句话描述这个技能的作用（200字符以内）" +category: your-category +risk: safe +source: community +date_added: "YYYY-MM-DD" +author: your-name-or-handle +tags: [tag-one, tag-two] +tools: [claude, cursor, gemini] +--- + +# 技能标题 + +## 概述 + +简要说明这个技能的作用以及它为什么存在。 +2-4句话最合适。 + +## 何时使用此技能 + +- 当您需要[场景1]时使用 +- 在处理[场景2]时使用 +- 当用户询问[场景3]时使用 + +## 工作原理 + +### 步骤1：[操作] + +详细说明... + +### 步骤2：[操作] + +更多说明... + +## 示例 + +### 示例1：[用例] + +```javascript +// 示例代码或说明 +``` + +### 示例2：[用例] + +```python +# Python示例代码 +``` + +## 最佳实践 + +- 实践建议1 +- 实践建议2 +- 避免的陷阱 + +## 相关技能 + +- `@related-skill-1` - 相关说明 +- `@related-skill-2` - 相关说明 + +## 常见问题 + +**Q: 常见问题？** +A: 详细回答... + +## 限制和注意事项 + +- 限制1 +- 限制2 +- 注意事项 + +--- + +## 技能模板使用指南 + +### 📋 前置内容字段说明 + +**必需字段：** + +- `name`: 技能名称（小写，连字符分隔） +- `description`: 一句话技能描述（200字符以内，以中文引号包围） +- `category`: 技能分类（见下方分类列表） +- `risk`: 风险级别（safe/medium/high） +- `source`: 来源（community/official） +- `date_added`: 添加日期（YYYY-MM-DD格式） +- `author`: 作者名称或handle +- `tags`: 标签列表（最大5个） +- `tools`: 支持的工具列表（claude/cursor/gemini/codex/antigravity等） + +**示例：** +```yaml +--- +name: react-patterns +description: "React组件设计和状态管理的最佳实践" +category: development +risk: safe +source: community +date_added: "2024-01-15" +author: zhangsan +tags: [react, frontend, patterns, components] +tools: [claude, cursor, gemini] +--- +``` + +### 🎯 技能分类列表 + +**开发类：** +- `development` - 通用开发 +- `frontend` - 前端开发 +- `backend` - 后端开发 +- `mobile` - 移动开发 +- `testing` - 测试 +- `devops` - DevOps + +**架构类：** +- `architecture` - 系统架构 +- `design` - 设计模式 +- `database` - 数据库设计 +- `api` - API设计 + +**安全类：** +- `security` - 安全审计 +- `pen-testing` - 渗透测试 +- `compliance` - 合规检查 +- `cryptography` - 加密 + +**AI类：** +- `ai` - 人工智能 +- `machine-learning` - 机器学习 +- `prompt-engineering` - 提示工程 +- `data-science` - 数据科学 + +**工具类：** +- `git` - Git操作 +- `productivity` - 生产力 +- `documentation` - 文档编写 +- `deployment` - 部署 + +**业务类：** +- `product` - 产品管理 +- `planning` - 项目规划 +- `communication` - 沟通协作 +- `research` - 研究分析 + +### ⚠️ 风险级别定义 + +**safe（安全）：** +- 代码审查和设计建议 +- 文档编写和规范指导 +- 标准操作流程 + +**medium（中等）：** +- 系统修改和配置更改 +- 数据处理和转换 +- 自动化脚本执行 + +**high（高风险）：** +- 数据库修改和删除操作 +- 生产环境更改 +- 安全相关操作 + +### 🏷️ 标签规范 + +**命名规则：** +- 小写字母 +- 连字符分隔 +- 避免特殊字符 +- 最多5个标签 + +**常用标签：** +- 技术标签：`react`, `python`, `aws`, `kubernetes` +- 概念标签：`patterns`, `security`, `performance`, `testing` +- 领域标签：`frontend`, `backend`, `mobile`, `api` + +### 🛠️ 工具支持 + +**支持的工具：** +- `claude` - Claude Code +- `cursor` - Cursor IDE +- `gemini` - Gemini CLI +- `codex` - Codex CLI +- `antigravity` - Antigravity IDE +- `opencode` - OpenCode CLI +- `kiro` - Kiro CLI + +### 📝 内容结构指南 + +**必需章节：** + +1. **概述（Overview）** + - 2-4句话说明技能作用 + - 解释为什么需要这个技能 + +2. **何时使用（When to Use This Skill）** + - 具体的使用场景 + - 使用条件说明 + +3. **工作原理（How It Works）** + - 逐步操作说明 + - 清晰的执行流程 + +**可选章节：** + +4. **示例（Examples）** + - 具体使用示例 + - 代码片段或配置 + +5. **最佳实践（Best Practices）** + - 推荐的用法 + - 避免的陷阱 + +6. **相关技能（Related Skills）** + - 相关的其他技能 + - 技能组合建议 + +7. **常见问题（FAQ）** + - 常见问题和解答 + - 故障排除指南 + +8. **限制和注意事项（Limitations）** + - 技能的限制 + - 使用注意事项 + +### ✅ 质量检查清单 + +**内容质量：** +- [ ] 描述清晰准确 +- [ ] 示例可运行 +- [ ] 文档完整 +- [ ] 语言简洁明了 + +**格式规范：** +- [ ] 前置内容完整 +- [ ] 分类正确 +- [ ] 标签合适 +- [ ] 工具支持明确 + +**技术质量：** +- [ ] 指导可执行 +- [ ] 最佳实践遵循 +- [ ] 安全考虑周全 +- [ ] 错误处理合理 + +### 🚀 提交指南 + +**文件命名：** +- 使用小写字母和连字符 +- 不要包含特殊字符 +- 目录名与技能名称一致 +- 文件名为：`SKILL.md` + +**目录结构：** +``` +skills/ +├── skill-name/ +│ ├── SKILL.md +│ ├── examples/ +│ │ ├── example1.md +│ │ └── example2.md +│ └── scripts/ +│ └── helper-script.py +``` + +**提交流程：** +1. Fork仓库 +2. 创建技能目录 +3. 编写SKILL.md文件 +4. 添加示例和脚本（可选） +5. 运行验证：`npm run validate` +6. 提交Pull Request + +### 📞 获取帮助 + +**资源链接：** +- 📋 [技能结构详细说明](skill-anatomy.md) +- 🎯 [质量标准](quality-bar.md) +- 🤝 [社区讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) +- 🐛 [问题报告](https://github.com/sickn33/antigravity-awesome-skills/issues) + +**联系方式：** +- 📧 skills@antigravity-skills.org +- 💬 Discord: #技能贡献频道 + +--- + +## 🎉 开始贡献 + +感谢您考虑为Antigravity Awesome Skills贡献！使用这个模板，您可以帮助创建高质量、一致性的技能，让整个社区受益。 + +如果您有任何疑问或需要指导，请随时联系我们。 + +**期待您的贡献！** 🚀 \ No newline at end of file diff --git a/docs_zh-CN/maintainers/audit.md b/docs_zh-CN/maintainers/audit.md new file mode 100644 index 00000000..f04a5832 --- /dev/null +++ b/docs_zh-CN/maintainers/audit.md @@ -0,0 +1,68 @@ +# 仓库一致性和正确性审计 + +本文档总结了在 `apps/` + `tools/` + 分层 `docs/` 重构后执行的仓库一致性审计。 + +## 范围 + +- 计数和数字（README、package.json、CATALOG） +- 技能验证（frontmatter、风险、"When to Use"、链接） +- 交叉引用（workflows.json、bundles.json、`docs/users/bundles.md`） +- 文档（`docs/contributors/quality-bar.md`、`docs/contributors/skill-anatomy.md`、安全/许可证） +- 脚本和构建（validate、index、readme、catalog、test） +- 关于 data/ 和测试 YAML 的说明 + +## 结果 + +### 1. 计数 + +- `README.md`、`package.json` 和生成的工件与当前集合大小（`1,204+` 技能）保持一致。 +- `npm run sync:all` 和 `npm run catalog` 是保持计数和生成文件同步的规范命令。 + +### 2. 技能验证 + +- `npm run validate` 是操作性的贡献者关卡。 +- `npm run validate:strict` 目前是一个诊断强化通道：它仍然会在许多旧技能中显示仓库范围的遗留元数据/内容缺口。 +- 验证器接受 `risk: unknown` 用于遗留/未分类的技能，同时仍然希望新技能具有具体的风险值。 + +### 3. 交叉引用 + +- 添加了 `tools/scripts/validate_references.py`（也作为 `npm run validate:references` 公开），它验证： + - data/workflows.json 中的每个 `recommendedSkills` 都存在于 skills/ 中 + - 每个 `relatedBundles` 都存在于 data/bundles.json 中 + - data/bundles.json 中的每个 slug（技能列表）都存在于 skills/ 中 + - `docs/users/bundles.md` 中的每个技能链接都指向现有技能。 +- 执行：`npm run validate:references`。结果：所有引用有效。 + +### 4. 文档 + +- 规范的贡献者文档现在位于 `docs/contributors/`。 +- 规范的维护者文档现在位于 `docs/maintainers/`。 +- README、安全文档、许可证和内部 markdown 链接在重构后已重新检查。 + +### 5. 脚本和构建 + +- `npm run test` 和 `npm run app:build` 在重构的布局上成功完成。 +- `validate_skills_headings.test.js` 充当轻量级回归/冒烟测试，而不是完整元数据合规性的真实来源。 +- 维护者文档现在需要与根 `package.json` 和重构的 `tools/scripts/*` 路径保持一致。 + +### 6. 可交付成果 + +- 计数与当前生成的注册表一致。 +- 引用验证连接到重构的路径。 +- 用户和维护者文档在布局更改后检查了路径漂移。 +- 后续工作仍开放：需要仓库范围的清理以使 `validate:strict` 完全通过。 + +## 有用命令 + +```bash +npm run validate # 技能验证（软） +npm run validate:strict # 强化/诊断通道 +npm run validate:references # workflow、bundle 和 docs/users/bundles.md 引用 +npm run build # chain + catalog +npm test # 测试套件 +``` + +## 未解决的问题/后续工作 + +- 逐步清理旧技能，以便 `npm run validate:strict` 可以在未来成为严格的 CI 关卡。 +- 在规范英语文档稳定后，在单独的通道中保持翻译文档的一致性。 diff --git a/docs_zh-CN/maintainers/ci-drift-fix.md b/docs_zh-CN/maintainers/ci-drift-fix.md new file mode 100644 index 00000000..491e132f --- /dev/null +++ b/docs_zh-CN/maintainers/ci-drift-fix.md @@ -0,0 +1,38 @@ +# CI 漂移修复指南 + +**问题**：失败的作业是由于在更新脚本运行后在 `README.md`、`skills_index.json` 或目录文件中检测到未提交的更改引起的。 + +**错误**： + +``` +❌ 检测到由 registry/readme/catalog 脚本产生的未提交更改。 +``` + +**原因**： +像 `tools/scripts/generate_index.py`、`tools/scripts/update_readme.py` 和 `tools/scripts/build-catalog.js` 这样的脚本会修改 `README.md`、`skills_index.json`、`data/catalog.json`、`data/bundles.json`、`data/aliases.json` 和 `CATALOG.md`。工作流期望这些文件在脚本运行后没有更改。任何差异意味着提交的仓库与生成脚本产生的内容不同步。 + +**如何修复（每次都要这样做）：** + +1. 在本地运行**完整的验证链**： + + ```bash + npm run chain + npm run catalog + ``` + +2. 检查更改： + + ```bash + git status + git diff + ``` + +3. 提交并推送任何更新： + ```bash + git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md + git commit -m "chore: sync generated registry files" + git push + ``` + +**总结**： +始终提交并推送 registry、README 同步和 catalog 脚本产生的所有更改。这通过确保仓库和生成的工件与规范的 `tools/scripts/*` 管道保持同步，保持 CI 通过。 diff --git a/docs_zh-CN/maintainers/release-process.md b/docs_zh-CN/maintainers/release-process.md new file mode 100644 index 00000000..125d47b6 --- /dev/null +++ b/docs_zh-CN/maintainers/release-process.md @@ -0,0 +1,432 @@ +# 发布流程 + +这是维护者的仓库发布操作手册。历史发布记录在[`CHANGELOG.md`](../../CHANGELOG.md)中；本文档记录可重复的流程。 + +## 前置条件 + +- 工作目录是干净的，或者您已经明确隔离了发布更改。 +- `package.json`包含您打算发布的版本。 +- 生成的注册表文件已同步。 +- README统计、徽章和致谢是最新的。 + +## 发布检查清单 + +### 1. 运行操作验证套件： + +```bash +npm run validate +npm run validate:references +npm run sync:all +npm run test +npm run app:build +``` + +### 2. 可选的强化检查： + +```bash +npm run validate:strict +``` + +将其用作诊断信号。它有助于发现历史质量债务，但目前还不是整个仓库的发布阻止因素。 + +### 3. 更新版本号： + +```bash +# 更新package.json中的版本 +npm version patch|minor|major + +# 或手动更新为特定版本 +npm version 1.2.3 +``` + +### 4. 生成变更日志： + +```bash +npm run changelog +``` + +审查生成的变更日志，确保： +- 所有重要更改都已记录 +- 版本号正确 +- 破坏性变更已标记 +- 新功能已突出显示 + +### 5. 更新文档： + +```bash +npm run readme +npm run catalog +``` + +验证： +- README中的技能数量正确 +- 新技能已分类 +- 示例代码可运行 +- 链接有效 + +### 6. 运行完整测试套件： + +```bash +npm run test:ci +``` + +确保： +- 所有测试通过 +- 代码覆盖率达标 +- 安全检查通过 +- 性能基准稳定 + +### 7. 创建发布分支： + +```bash +git checkout -b release/vX.X.X +``` + +### 8. 提交所有更改： + +```bash +git add . +git commit -m "chore: prepare release v$VERSION" +``` + +### 9. 创建标签： + +```bash +git tag -a v$VERSION -m "Release v$VERSION" +``` + +### 10. 推送更改和标签： + +```bash +git push origin main +git push origin release/vX.X.X +git push origin v$VERSION +``` + +## 发布后操作 + +### 1. 合并发布分支： + +```bash +git checkout main +git merge release/vX.X.X +git push origin main +``` + +### 2. 发布到NPM： + +```bash +npm publish +``` + +### 3. 创建GitHub Release： + +- 访问 [GitHub Releases页面](https://github.com/sickn33/antigravity-awesome-skills/releases) +- 点击"Create a new release" +- 选择刚推送的标签 +- 粘贴变更日志内容 +- 添加发布说明 +- 点击"Publish release" + +### 4. 更新网站和文档： + +```bash +npm run deploy:docs +npm run deploy:web +``` + +### 5. 社区公告： + +#### Discord公告： +```text +🎉 Antigravity Awesome Skills v$VERSION 已发布！ + +主要更新： +• [关键更新1] +• [关键更新2] +• [关键更新3] + +获取更新：npx antigravity-awesome-skills + +详情：[GitHub Release链接] +``` + +#### Twitter公告： +```text +🚀 Antigravity Awesome Skills v$VERSION 发布了！ + +[最激动人心的新功能] + +立即更新：npx antigravity-awesome-skills + +#AI #Skills #ClaudeCode #Gemini +``` + +#### 博客文章： +- 撰写详细的发布说明 +- 包含新功能示例 +- 添加迁移指南 +- 分享最佳实践 + +## 紧急发布流程 + +### 何时需要紧急发布： + +- 关键安全漏洞修复 +- 生产环境破坏性bug +- 重大安装问题 + +### 紧急发布步骤： + +1. **立即修复** + ```bash + git checkout -b hotfix/issue-description + # 实施修复 + npm test + ``` + +2. **快速验证** + ```bash + npm run validate:quick + ``` + +3. **发布修复** + ```bash + npm version patch + git tag v$VERSION + git push origin v$VERSION + npm publish + ``` + +4. **通知社区** + - Discord紧急通知 + - GitHub Issue说明 + - Twitter安全公告 + +## 版本控制策略 + +### 语义化版本控制 + +遵循[SemVer](https://semver.org/)规范： + +- **主版本号（MAJOR）**：不兼容的API更改 +- **次版本号（MINOR）**：向后兼容的功能添加 +- **修订号（PATCH）**：向后兼容的问题修复 + +### 版本号格式 + +``` +MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD] +``` + +示例： +- `1.0.0` - 稳定发布 +- `1.0.0-alpha.1` - Alpha版本 +- `1.0.0-beta.2` - Beta版本 +- `1.0.0-rc.3` - 候选版本 + +### 发布周期 + +- **主版本**：每3-6个月 +- **次版本**：每月 +- **修订版本**：根据需要（bug修复） + +## 质量门禁 + +### 发布前检查 + +**必须通过：** +- [ ] 所有自动化测试通过 +- [ ] 代码覆盖率 > 80% +- [ ] 安全扫描无高危漏洞 +- [ ] 性能测试无回归 +- [ ] 文档生成成功 +- [ ] 技能验证通过 + +**可选通过：** +- [ ] 严格验证通过 +- [ ] 手动QA验证 +- [ ] 社区反馈收集 + +### 发布后监控 + +**监控指标：** +- NPM下载量 +- GitHub Stars +- 社区反馈 +- 错误报告 +- 性能指标 + +**告警阈值：** +- 下载量下降 > 20% +- 错误率上升 > 5% +- 社区投诉 > 10条 + +## 回滚程序 + +### 何时回滚 + +- 安装失败率 > 10% +- 关键功能破坏 +- 安全问题发现 +- 用户大量投诉 + +### 回滚步骤 + +1. **立即停止推广** + - 撤下发布说明 + - 更新Discord状态 + - 暂停Twitter宣传 + +2. **创建回滚分支** + ```bash + git checkout -b rollback/v$VERSION + git revert $MERGE_COMMIT + ``` + +3. **发布回滚版本** + ```bash + npm version patch + git tag v$ROLLBACK_VERSION + npm publish + ``` + +4. **社区通知** + ```text + 🚨 v$VERSION 紧急回滚 + + 问题：[问题描述] + 解决：[回滚版本 v$ROLLBACK_VERSION] + + 建议：暂缓更新或使用 --version $ROLLBACK_VERSION + ``` + +## 工具和自动化 + +### 发布脚本 + +```bash +#!/bin/bash +# release.sh - 自动化发布脚本 + +set -e + +VERSION=$(node -p "require('./package.json').version") +echo "🚀 发布版本 v$VERSION" + +# 运行检查 +npm run validate +npm run test + +# 更新文档 +npm run readme +npm run catalog + +# 创建发布 +git add . +git commit -m "chore: release v$VERSION" +git tag -a v$VERSION -m "Release v$VERSION" + +# 推送 +git push origin main +git push origin v$VERSION + +# 发布到NPM +npm publish + +echo "✅ 发布成功 v$VERSION" +``` + +### 持续集成配置 + +**GitHub Actions工作流：** +```yaml +name: Release +on: + push: + tags: + - 'v*' +jobs: + release: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - uses: actions/setup-node@v3 + - run: npm ci + - run: npm test + - run: npm publish +``` + +## 贡献者认可 + +### 发布致谢 + +在每个发布中感谢贡献者： + +```markdown +## 贡献者 + +特别感谢本版本的贡献者： +- @username - [主要贡献] +- @username2 - [主要贡献] +- @username3 - [主要贡献] + +以及所有报告问题和反馈的用户！ +``` + +### 奖励机制 + +- 🏆 **月度贡献者** - Discord特别角色 +- 🎁 **发布贡献者** - 项目商品 +- 📝 **技术写作奖** - 优秀文档奖 +- 🌟 **新星奖** - 新贡献者鼓励 + +## 文档和培训 + +### 维护者培训 + +**新维护者入职：** +1. 阅读完整的维护者文档 +2. 观摩一次完整的发布流程 +3. 在监督下进行一次发布 +4. 独立执行发布（有回滚支持） + +### 技能文档 + +**必备文档：** +- 发布流程检查清单 +- 紧急响应程序 +- 工具使用指南 +- 常见问题解答 + +**可选文档：** +- 高级故障排除 +- 性能优化指南 +- 社区管理最佳实践 + +--- + +## 🎉 成功发布指标 + +### 发布成功标志 + +- ✅ 所有自动化检查通过 +- ✅ 社区反馈积极 +- ✅ 下载量稳步增长 +- ✅ 错误率在可接受范围内 +- ✅ 文档完整准确 + +### 持续改进 + +每次发布后进行： +- 📊 性能分析 +- 📋 用户反馈收集 +- 🔄 流程优化 +- 📚 文档更新 +- 🎯 目标调整 + +--- + +这个发布流程确保Antigravity Awesome Skills的质量、稳定性和社区满意度。通过遵循这些指导方针，我们能够为用户提供可靠、高质量的技能生态。 + +如果您有任何问题或建议，请随时联系维护团队。🚀 \ No newline at end of file diff --git a/docs_zh-CN/quality-bar.md b/docs_zh-CN/quality-bar.md new file mode 100644 index 00000000..92a3a471 --- /dev/null +++ b/docs_zh-CN/quality-bar.md @@ -0,0 +1,394 @@ +# 技能质量标准 + +## 概述 + +本文档定义了Antigravity Awesome Skills项目中技能的质量标准和评估标准。所有提交的技能都必须满足这些标准才能被接受。 + +--- + +## 质量维度 + +### 1. 内容质量（Content Quality） + +**必须满足：** +- ✅ **准确性**：技术信息正确，无错误概念 +- ✅ **完整性**：涵盖主要使用场景，步骤完整 +- ✅ **清晰性**：语言简洁明了，逻辑清楚 +- ✅ **实用性**：解决实际问题，有明确价值 + +**评分标准：** +- **优秀（5分）**：超出预期，包含高级技巧和深度见解 +- **良好（4分）**：满足所有要求，内容详实 +- **合格（3分）**：基本要求满足，功能完整 +- **改进（2分）**：部分要求满足，需要补充 +- **不合格（1分）**：严重缺陷，需要重写 + +### 2. 格式规范（Format Standards） + +**前置内容要求：** +- ✅ `name`：小写+连字符，与目录名匹配 +- ✅ `description`：200字符以内，简洁明确 +- ✅ `category`：正确的分类标识 +- ✅ `risk`：合适的风险级别 +- ✅ `date_added`：YYYY-MM-DD格式 +- ✅ 必需字段完整，无拼写错误 + +**内容结构要求：** +- ✅ 标准章节结构（概述、使用场景、工作原理等） +- ✅ 代码块语法正确 +- ✅ 链接有效且格式正确 +- ✅ 技能引用使用`@skill-name`格式 + +### 3. 技术质量（Technical Quality） + +**代码示例要求：** +- ✅ 代码可运行，语法正确 +- ✅ 遵循语言最佳实践 +- ✅ 包含必要的错误处理 +- ✅ 性能考虑合理 + +**安全性要求：** +- ✅ 无已知安全漏洞 +- ✅ 输入验证完整 +- ✅ 敏感信息处理得当 +- ✅ 安全最佳实践遵循 + +### 4. 用户体验（User Experience） + +**易用性要求：** +- ✅ 新手能理解和跟随 +- ✅ 步骤清晰，可操作性 +- ✅ 预期结果明确 +- ✅ 故障排除信息充分 + +**学习价值要求：** +- ✅ 教学价值明确 +- ✅ 概念解释清楚 +- ✅ 示例覆盖主要场景 +- ✅ 最佳实践指导 + +--- + +## 评估流程 + +### 1. 自动化检查 + +**运行命令：** +```bash +npm run validate:skill skills/skill-name/ +npm run validate:frontmatter skills/skill-name/SKILL.md +npm run check-links skills/skill-name/SKILL.md +``` + +**检查项目：** +- 前置内容格式验证 +- YAML语法检查 +- 必需字段完整性 +- 内部链接有效性 +- 重复技能检测 + +### 2. 人工评估 + +**评估维度：** +- **技术准确性**：专家审核技术内容 +- **实用价值**：评估解决实际问题的能力 +- **内容质量**：评估写作质量和组织结构 +- **创新性**：评估技能的独特性和创新点 + +**评估流程：** +1. 技术专家审核（必需） +2. 维护者综合评估（必需） +3. 社区反馈收集（可选） +4. 最终质量决策（必需） + +### 3. 质量分数计算 + +**权重分配：** +- 内容质量：40% +- 格式规范：20% +- 技术质量：25% +- 用户体验：15% + +**合格标准：** +- 总分 ≥ 3.0（满分5分） +- 无"不合格"维度 +- 安全性必须"合格"或以上 + +--- + +## 不同质量等级的要求 + +### 🌟 优秀技能（4.5-5.0分） + +**内容要求：** +- 超出基本需求的深度内容 +- 包含高级技巧和专家见解 +- 多个复杂示例和边界情况处理 +- 完整的故障排除指南 + +**格式要求：** +- 完美的格式规范 +- 丰富的代码注释 +- 详细的性能考虑 +- 优秀的学习路径设计 + +**技术要求：** +- 生产级代码质量 +- 全面的安全考虑 +- 优秀的性能表现 +- 完整的错误处理 + +**示例：** +```markdown +## 高级技巧 +这里提供一些专家级别的优化技巧... + +## 性能考虑 +在大型应用中，需要注意以下性能点... +``` + +### 🎯 良好技能（3.5-4.4分） + +**内容要求：** +- 满足所有核心需求 +- 内容详实且准确 +- 适当的使用示例 +- 基本的故障排除 + +**格式要求：** +- 遵循所有格式规范 +- 代码示例正确 +- 链接有效 +- 结构清晰 + +**技术要求：** +- 代码质量良好 +- 基本安全考虑 +- 合理的性能处理 +- 适当错误处理 + +### ✅ 合格技能（3.0-3.4分） + +**内容要求：** +- 基本功能完整 +- 主要使用场景覆盖 +- 基本准确性保证 +- 简单示例提供 + +**格式要求：** +- 基本格式正确 +- 前置内容完整 +- 基本结构符合 + +**技术要求：** +- 代码基本可用 +- 无明显安全问题 +- 基本错误处理 + +### ⚠️ 改进技能（2.0-2.9分） + +**需要改进的常见问题：** +- 内容不够详细或不够准确 +- 示例不完整或有错误 +- 格式部分不符合要求 +- 技术实现有待改进 + +**改进建议：** +- 补充缺失的使用场景 +- 修正代码示例错误 +- 完善格式规范 +- 增强技术实现 + +### ❌ 不合格技能（<2.0分） + +**严重问题示例：** +- 技术信息错误 +- 内容不完整 +- 格式严重不符 +- 安全问题存在 + +**处理方式：** +- 直接拒绝，提供详细反馈 +- 要求重大修改后重新提交 +- 建议参考高质量技能学习 + +--- + +## 具体质量标准 + +### 安全技能质量标准 + +**额外要求：** +- ✅ 安全风险评估完整 +- ✅ 漏洞扫描方法可靠 +- ✅ 修复建议实用可行 +- ✅ 合规要求明确 + +**安全等级分类：** +- **低风险（Safe）**：代码审查、文档指导 +- **中等风险（Medium）**：系统配置、数据处理 +- **高风险（High）**：生产环境修改、安全测试 + +### AI技能质量标准 + +**额外要求：** +- ✅ 提示工程技巧专业 +- ✅ AI伦理考虑充分 +- ✅ 模型适用范围明确 +- ✅ 输出质量控制方法 + +**特殊评估项：** +- 提示质量优化效果 +- 上下文管理策略 +- 错误恢复机制 +- 性能和成本考虑 + +### 前端技能质量标准 + +**额外要求：** +- ✅ 兼容性考虑全面 +- ✅ 性能优化策略有效 +- ✅ 用户体验细节到位 +- ✅ 现代最佳实践遵循 + +**技术评估重点：** +- 组件设计模式 +- 状态管理策略 +- 构建和部署流程 +- 测试覆盖度 + +### 后端技能质量标准 + +**额外要求：** +- ✅ API设计符合规范 +- ✅ 数据处理安全高效 +- ✅ 可扩展性考虑充分 +- ✅ 监控和日志完整 + +**架构评估重点：** +- 系统设计合理性 +- 数据库设计优化 +- 安全架构完整性 +- 性能和可维护性 + +--- + +## 质量提升指导 + +### 常见问题及解决方案 + +**1. 内容过于简单** +- 问题：只有基础信息，缺乏深度 +- 解决：添加高级技巧、边界情况处理、最佳实践 + +**2. 示例代码错误** +- 问题：代码无法运行或有语法错误 +- 解决：实际测试每个示例，添加完整上下文 + +**3. 格式不规范** +- 问题：前置内容缺失或格式错误 +- 解决：严格遵循模板，运行验证工具 + +**4. 缺乏实际价值** +- 问题：理论过多，实用性不足 +- 解决：增加真实场景示例，提供可操作指导 + +### 质量改进建议 + +**内容改进：** +- 增加更多实际使用案例 +- 提供详细的故障排除指南 +- 添加性能优化建议 +- 包含最佳实践总结 + +**格式改进：** +- 使用更清晰的章节结构 +- 添加更多代码注释 +- 改进示例的实用性 +- 增强可读性 + +**技术改进：** +- 优化代码质量和性能 +- 增强安全性考虑 +- 完善错误处理 +- 提供扩展性指导 + +--- + +## 评估工具和资源 + +### 自动化工具 + +**质量检查工具：** +```bash +# 运行所有质量检查 +npm run quality:check skills/skill-name/ + +# 生成质量报告 +npm run quality:report skills/skill-name/ + +# 比较质量指标 +npm run quality:compare skills/skill-name/ +``` + +**检查项目：** +- 内容深度分析 +- 代码质量评估 +- 安全性扫描 +- 性能基准测试 + +### 评估资源 + +**参考标准：** +- [技能结构指南](skill-anatomy.md) +- [代码规范指南](coding-standards.md) +- [安全最佳实践](security-best-practices.md) +- [性能优化指南](performance-guidelines.md) + +**质量模板：** +- [优秀技能示例](examples/excellent-skill/) +- [常见错误示例](examples/common-mistakes/) +- [改进前后的对比](examples/before-after/) + +--- + +## 社区参与 + +### 质量反馈机制 + +**用户反馈渠道：** +- GitHub Issues中的质量问题 +- Discord中的技能讨论 +- 社区调查和评分 +- 使用统计和性能数据 + +**反馈处理流程：** +1. 收集和分类反馈 +2. 评估影响和优先级 +3. 制定改进计划 +4. 实施改进并验证 +5. 通知相关贡献者 + +### 持续改进 + +**质量监控指标：** +- 技能使用频率和成功率 +- 用户满意度和评分 +- 社区贡献和改进建议 +- 技术债务累积情况 + +**定期质量审查：** +- 月度质量报告 +- 季度标准更新 +- 年度质量目标调整 +- 持续流程优化 + +--- + +## 总结 + +这个质量标准确保了Antigravity Awesome Skills项目中每个技能都能为用户提供高质量、实用、安全的价值。通过明确的标准、严格的评估流程和持续的改进机制，我们建立了技能质量的信任和可靠性。 + +所有贡献者都应该仔细阅读并遵循这些标准，在提交技能前进行自我评估。维护者将根据这些标准进行公平、透明的评估。 + +如果您对质量标准有任何疑问或建议，欢迎参与社区讨论或联系维护团队。🚀 \ No newline at end of file diff --git a/docs_zh-CN/skill-anatomy.md b/docs_zh-CN/skill-anatomy.md new file mode 100644 index 00000000..d46d09b4 --- /dev/null +++ b/docs_zh-CN/skill-anatomy.md @@ -0,0 +1,532 @@ +# 技能结构指南 + +## 什么是技能？ + +技能是专门的教学文档，指导AI助手（如Claude Code、Gemini、Cursor）如何完美执行特定任务。 + +每个技能都是一个自包含的markdown文件，包含AI理解上下文所需的所有必要信息、分步指导和相关代码示例。 + +--- + +## 技能文件结构 + +### 目录结构 + +``` +skills/ +├── skill-name/ # 技能目录 +│ ├── SKILL.md # 主要技能文件（必需） +│ ├── examples/ # 示例目录（可选） +│ │ ├── basic-usage.md # 基础使用示例 +│ │ └── advanced-scenarios.md # 高级场景示例 +│ ├── resources/ # 资源目录（可选） +│ │ ├── templates/ # 代码模板 +│ │ ├── checklists/ # 检查清单 +│ │ └── references/ # 参考资料 +│ └── scripts/ # 辅助脚本（可选） +│ ├── validate.py # 验证脚本 +│ └── helper.sh # 辅助脚本 +``` + +### 文件命名规则 + +- **目录名**：小写字母，连字符分隔（如：`react-patterns`） +- **主文件**：总是命名为 `SKILL.md`（大写） +- **示例文件**：使用有意义的名称，`.md` 扩展名 +- **脚本文件**：使用适合文件扩展名（`.py`、`.sh`、`.js`） + +--- + +## SKILL.md 文件格式 + +### 1. 前置内容（YAML Frontmatter） + +```yaml +--- +name: skill-name # 必需：技能名称 +description: "简要技能描述" # 必需：一句话描述，200字符以内 +category: development # 必需：技能分类 +risk: safe # 必需：风险级别（safe/medium/high） +source: community # 必需：来源（community/official） +date_added: "2024-01-15" # 必需：添加日期，YYYY-MM-DD格式 +author: your-username # 可选：作者 +tags: [react, frontend, patterns] # 可选：标签列表，最多5个 +tools: [claude, cursor, gemini] # 可选：支持工具列表 +--- +``` + +**字段说明：** + +| 字段 | 必需 | 格式 | 说明 | +|------|------|------|------| +| `name` | ✅ | 小写+连字符 | 技能标识符，用于`@skill-name`调用 | +| `description` | ✅ | 引号字符串 | 简洁描述，说明技能用途 | +| `category` | ✅ | 小写字符串 | 技能分类（见分类列表） | +| `risk` | ✅ | safe/medium/high | 风险级别，影响使用警告 | +| `source` | ✅ | community/official | 来源标识，官方或社区 | +| `date_added` | ✅ | YYYY-MM-DD | 技能添加日期 | +| `author` | ❌ | 字符串 | 贡献者用户名 | +| `tags` | ❌ | 数组 | 搜索和分类标签 | +| `tools` | ❌ | 数组 | 支持的AI工具列表 | + +### 2. 技能内容结构 + +```markdown +# 技能标题 + +## 概述 +2-4句话解释这个技能的作用和为什么存在。 + +## 何时使用此技能 +- 当您需要[具体场景1]时使用 +- 在处理[具体场景2]时使用 +- 当用户询问[具体场景3]时使用 + +## 工作原理 + +### 步骤1：[操作名称] +详细的操作说明... + +### 步骤2：[操作名称] +更多的操作说明... + +## 示例 + +### 示例1：[用例标题] +```javascript +// 代码示例或配置 +``` + +### 示例2：[用例标题] +```python +# Python示例代码 +``` + +## 最佳实践 +- 实践建议1 +- 实践建议2 +- 避免的陷阱 + +## 相关技能 +- `@related-skill-1` - 关系说明 +- `@related-skill-2` - 关系说明 + +## 常见问题 +**Q: 常见问题？** +A: 详细回答... + +## 限制和注意事项 +- 技能限制1 +- 使用注意事项1 +``` + +--- + +## 技能分类系统 + +### 开发类（Development） + +**前端开发（Frontend）** +- `frontend` - 通用前端开发 +- `react` - React框架 +- `vue` - Vue框架 +- `angular` - Angular框架 +- `css` - CSS和样式 +- `javascript` - JavaScript语言 + +**后端开发（Backend）** +- `backend` - 通用后端开发 +- `api` - API设计和开发 +- `database` - 数据库相关 +- `microservices` - 微服务架构 +- `nodejs` - Node.js开发 +- `python` - Python后端 + +**移动开发（Mobile）** +- `mobile` - 通用移动开发 +- `react-native` - React Native +- `flutter` - Flutter框架 +- `ios` - iOS开发 +- `android` - Android开发 + +**测试（Testing）** +- `testing` - 通用测试 +- `unit-testing` - 单元测试 +- `e2e-testing` - 端到端测试 +- `performance-testing` - 性能测试 +- `security-testing` - 安全测试 + +### DevOps和基础设施（DevOps & Infrastructure） + +**部署（Deployment）** +- `deployment` - 通用部署 +- `docker` - 容器化 +- `kubernetes` - 容器编排 +- `ci-cd` - 持续集成/部署 +- `cloud` - 云服务 + +**监控（Monitoring）** +- `monitoring` - 系统监控 +- `logging` - 日志管理 +- `observability` - 可观测性 +- `performance` - 性能优化 + +### 安全类（Security） + +**安全审计（Security Audit）** +- `security` - 通用安全 +- `pen-testing` - 渗透测试 +- `vulnerability` - 漏洞扫描 +- `compliance` - 合规检查 + +**安全实施（Security Implementation）** +- `authentication` - 身份认证 +- `authorization` - 授权控制 +- `encryption` - 加密技术 +- `secure-coding` - 安全编码 + +### AI和机器学习（AI & Machine Learning） + +**AI开发（AI Development）** +- `ai` - 通用AI开发 +- `llm` - 大语言模型 +- `prompt-engineering` - 提示工程 +- `ai-safety` - AI安全和伦理 + +**机器学习（Machine Learning）** +- `machine-learning` - 机器学习 +- `data-science` - 数据科学 +- `ml-ops` - 机器学习运维 +- `model-training` - 模型训练 + +### 业务和产品（Business & Product） + +**产品管理（Product Management）** +- `product` - 产品管理 +- `planning` - 项目规划 +- `requirements` - 需求分析 +- `user-research` - 用户研究 + +**商业分析（Business Analysis）** +- `analytics` - 数据分析 +- `metrics` - 指标分析 +- `reporting` - 报告生成 +- `business-intelligence` - 商业智能 + +### 工具和效率（Tools & Productivity） + +**开发工具（Dev Tools）** +- `git` - 版本控制 +- `editor` - 编辑器配置 +- `terminal` - 终端和CLI +- `productivity` - 生产力工具 + +**文档（Documentation）** +- `documentation` - 文档编写 +- `technical-writing` - 技术写作 +- `api-docs` - API文档 +- `tutorials` - 教程编写 + +--- + +## 质量标准 + +### 内容质量 + +**✅ 必须满足：** +- 描述清晰准确，无歧义 +- 示例可运行，代码正确 +- 步骤完整，逻辑清晰 +- 涵盖常见使用场景 + +**🎯 鼓励添加：** +- 高级用法示例 +- 常见错误处理 +- 性能优化建议 +- 最佳实践总结 + +### 格式规范 + +**✅ 必须遵守：** +- 前置内容完整且有效 +- 正确的分类和标签 +- 一致的代码块格式 +- 正确的技能引用（`@skill-name`） + +**🎯 推荐实践：** +- 添加目录结构说明 +- 包含相关技能链接 +- 提供故障排除指南 +- 添加性能指标 + +### 技术质量 + +**✅ 安全要求：** +- 代码安全，无已知漏洞 +- 输入验证完整 +- 错误处理适当 +- 不包含敏感信息 + +**✅ 性能要求：** +- 算法高效，复杂度合理 +- 资源使用优化 +- 内存泄漏防护 +- 扩展性考虑 + +--- + +## 技能示例 + +### 简单技能示例 + +```yaml +--- +name: git-commit-check +description: "检查Git提交消息格式和内容质量" +category: git +risk: safe +source: community +date_added: "2024-01-15" +tags: [git, commit, quality] +tools: [claude, cursor, gemini] +--- +``` + +```markdown +# Git提交检查 + +## 概述 +此技能用于检查Git提交消息的格式规范和内容质量，确保提交历史清晰可读。 + +## 何时使用此技能 +- 当您需要验证提交消息格式时使用 +- 在提交前进行质量检查时使用 +- 当团队需要统一提交标准时使用 + +## 工作原理 + +### 步骤1：格式检查 +验证提交消息是否遵循规范格式： +- 类型标签（feat/fix/docs等） +- 空行分隔 +- 简洁标题（50字符内） +- 详细描述（如需要） + +### 步骤2：内容检查 +检查提交内容的质量： +- 是否包含必要信息 +- 语法是否正确 +- 是否有拼写错误 + +## 示例 + +### 示例1：标准提交 +``` +feat: 添加用户认证功能 + +- 实现JWT认证 +- 添加登录/登出页面 +- 更新用户模型 +``` + +### 示例2：修复提交 +``` +fix: 修复登录页面重定向问题 + +解决用户登录后不能正确跳转到首页的bug +``` + +## 最佳实践 +- 使用约定式提交格式 +- 保持消息简洁明了 +- 包含相关Issue编号 +- 避免敏感信息泄露 +``` + +### 复杂技能示例 + +```yaml +--- +name: react-performance-optimization +description: "React应用性能优化和调试" +category: frontend +risk: medium +source: community +date_added: "2024-01-15" +tags: [react, performance, optimization] +tools: [claude, cursor, gemini] +--- +``` + +```markdown +# React性能优化 + +## 概述 +此技能提供React应用性能优化的系统性方法，包括识别瓶颈、应用优化策略和验证改进效果。 + +## 何时使用此技能 +- 当React应用加载缓慢时使用 +- 在用户体验需要优化时使用 +- 当进行性能评估时使用 +- 当准备生产部署时使用 + +## 工作原理 + +### 步骤1：性能评估 +识别性能瓶颈： +- 使用React DevTools Profiler +- 分析组件渲染时间 +- 检查内存使用情况 +- 识别重渲染问题 + +### 步骤2：优化策略 +应用优化技术： +- 组件懒加载 +- React.memo优化 +- 状态结构优化 +- 副作用优化 + +### 步骤3：验证改进 +确认优化效果： +- 重新运行性能测试 +- 对比优化前后指标 +- 确保功能完整性 +- 监控生产表现 + +## 示例 + +### 示例1：组件优化 +```javascript +// 优化前 +function TodoList({ todos, onToggle }) { + return ( +
+ {todos.map(todo => ( + + ))} +
+ ) +} + +// 优化后 +const TodoItem = React.memo(({ todo, onToggle }) => { + return
onToggle(todo.id)}>{todo.text}
+}) + +function TodoList({ todos, onToggle }) { + const memoizedToggle = useCallback(onToggle, []) + + return ( +
+ {todos.map(todo => ( + + ))} +
+ ) +} +``` + +### 示例2：路由懒加载 +```javascript +// 优化前 +import Home from './pages/Home' +import Profile from './pages/Profile' +import Settings from './pages/Settings' + +// 优化后 +const Home = lazy(() => import('./pages/Home')) +const Profile = lazy(() => import('./pages/Profile')) +const Settings = lazy(() => import('./pages/Settings')) + +function App() { + return ( + + Loading...}> + } /> + } /> + } /> + + + ) +} +``` + +## 最佳实践 +- 先测量，再优化 +- 专注于用户感知的性能 +- 避免过早优化 +- 持续监控性能指标 +- 平衡优化和代码可维护性 +``` + +--- + +## 贡献指南 + +### 创建新技能 + +1. **选择分类**：参考分类系统确定合适分类 +2. **创建目录**：遵循命名规范创建技能目录 +3. **编写内容**：按照格式要求编写SKILL.md +4. **添加示例**：提供实际可运行的示例代码 +5. **验证质量**：运行质量检查工具 + +### 验证命令 + +```bash +# 验证技能格式 +npm run validate:skill skills/your-skill-name/ + +# 验证前置内容 +npm run validate:frontmatter skills/your-skill-name/ + +# 生成技能索引 +npm run index +``` + +### 提交流程 + +1. Fork仓库 +2. 创建特性分支 +3. 添加技能文件 +4. 运行验证测试 +5. 提交Pull Request + +--- + +## 质量保证 + +### 自动化检查 + +- **格式验证**：确保前置内容格式正确 +- **链接检查**：验证内部链接有效 +- **分类验证**：检查分类和标签合规 +- **重复检测**：避免技能重复 + +### 人工审核 + +- **内容准确性**：确保技术信息正确 +- **实用性评估**：评估技能实用价值 +- **用户体验**：确保易于理解和使用 +- **社区价值**：评估对社区的贡献 + +### 持续改进 + +- **用户反馈**：收集使用反馈 +- **性能监控**：监控技能使用效果 +- **定期更新**：根据技术发展更新内容 +- **质量提升**：持续改进技能质量 + +--- + +这个结构指南确保了技能的一致性、可维护性和高质量。遵循这些指导方针，您可以创建出对AI开发社区有价值的实用技能。 + +如果您有任何疑问或需要指导，请随时联系维护团队。🚀 \ No newline at end of file diff --git a/docs_zh-CN/sources/LICENSE-MICROSOFT b/docs_zh-CN/sources/LICENSE-MICROSOFT new file mode 100644 index 00000000..0b06372a --- /dev/null +++ b/docs_zh-CN/sources/LICENSE-MICROSOFT @@ -0,0 +1,62 @@ +MIT 许可证 + +版权所有 (c) Microsoft Corporation. + +特此免费授予任何获得本软件及相关文档文件（"软件"）副本的人不受限制地处理软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，并允许获得软件的人员这样做，但须符合以下条件： + +上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。 + +软件按"原样"提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易引起的、由软件或软件使用引起的或与之相关的任何索赔、损害或其他责任负责，无论是合同、侵权或其他方式的诉讼。 + +--- + +## Microsoft 许可证（中文翻译） + +**重要提示：** 此翻译仅供参考，法律效力以英文原文为准。 + +### MIT 许可证 + +**版权所有** © Microsoft Corporation。 + +**特此授予许可**，免费且无需签署协议，任何获得本软件及相关文档文件（"软件"）副本的人均可使用、复制、修改、合并、发布、分发、再许可和/或销售软件的副本，并允许获得软件的人员这样做，但须符合以下条件： + +**条件：** +上述版权声明和本许可声明必须包含在软件的所有副本或主要部分中。 + +**免责声明：** +软件按"原样"提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。 + +**责任限制：** +在任何情况下，无论是合同、侵权还是其他方式引起的索赔、损害或其他责任，作者或版权持有人均不对因软件或软件的使用或其他交易引起的、由软件或软件使用引起的或与之相关的任何事项负责。 + +--- + +### 适用范围 + +此许可证适用于： +- 本仓库中的 Microsoft 技能 +- Microsoft 技能的衍生作品 +- 与 Microsoft 技能相关的文档和示例 + +### 使用权利 + +您可以： +✅ **商业使用** - 在商业项目中使用 +✅ **修改** - 根据需要修改技能 +✅ **分发** - 包含在您的产品中 +✅ **私人使用** - 个人项目中使用 +✅ **再许可** - 在不同许可证下分发 + +### 条件 + +📋 **包含许可声明** - 在分发时必须包含原始许可证文本和版权声明 + +### 注意事项 + +⚠️ **无担保** - 技能按"原样"提供，不提供任何保证 +⚠️ **责任有限** - 作者不对使用技能造成的损害承担责任 +⚠️ **非排他性** - 此许可不授予 Microsoft 商标使用权 + +--- + +如果您对许可证有疑问，请联系 Microsoft 法律部门或咨询专业法律建议。 \ No newline at end of file diff --git a/docs_zh-CN/sources/sources.md b/docs_zh-CN/sources/sources.md new file mode 100644 index 00000000..e9815a94 --- /dev/null +++ b/docs_zh-CN/sources/sources.md @@ -0,0 +1,237 @@ +# 📜 来源与归属 + +我们相信应该给予应得的荣誉。 +如果您在这里发现了您的作品但没有正确归属，请提交Issue。 + +--- + +## 官方技能来源 + +| 技能/分类 | 原始来源 | 许可证 | 备注 | +| :---------------------------- | :------------------------------------------------------------------------ | :---------- | :---------------------------- | +| `cloud-penetration-testing` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | 适配为代理使用 | +| `active-directory-attacks` | [HackTricks](https://book.hacktricks.xyz/) | MIT / CC-BY-SA | 适配为代理使用 | +| `owasp-top-10` | [OWASP](https://owasp.org/) | CC-BY-SA | 方法论适配 | +| `burp-suite-testing` | [PortSwigger](https://portswigger.net/burp) | N/A | 仅使用指南（不含二进制） | +| `crewai` | [CrewAI](https://github.com/joaomdmoura/crewAI) | MIT | 框架指南 | +| `langgraph` | [LangGraph](https://github.com/langchain-ai/langgraph) | MIT | 框架指南 | +| `react-patterns` | [React Docs](https://react.dev/) | CC-BY | 官方模式 | +| **所有官方技能** | [Anthropic / Google / OpenAI / Microsoft / Supabase / Apify / Vercel Labs] | 专有 | 供应商鼓励使用 | + +--- + +## 来自VoltAgent/awesome-agent-skills的技能 + +以下技能来自精选集合[VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)： + +### 官方团队技能 + +| 技能 | 原始来源 | 许可证 | 备注 | +| :------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------ | :--------- | :--------------------------------- | +| `vercel-deploy-claimable` | [Vercel Labs](https://github.com/vercel-labs/agent-skills) | MIT | 官方Vercel技能 | +| `design-md` | [Google Labs (Stitch)](https://github.com/google-labs-code/stitch-skills) | Compatible | Google Labs Stitch技能 | +| `hugging-face-cli`, `hugging-face-jobs` | [Hugging Face](https://github.com/huggingface/skills) | Compatible | 官方Hugging Face技能 | +| `culture-index`, `fix-review`, `sharp-edges` | [Trail of Bits](https://github.com/trailofbits/skills) | Compatible | Trail of Bits安全技能 | +| `expo-deployment`, `upgrading-expo` | [Expo](https://github.com/expo/skills) | Compatible | 官方Expo技能 | +| `commit`, `create-pr`, `find-bugs`, `iterate-pr` | [Sentry](https://github.com/getsentry/skills) | Compatible | Sentry开发团队技能 | +| `using-neon` | [Neon](https://github.com/neondatabase/agent-skills) | Compatible | Neon Postgres最佳实践 | +| `fal-audio`, `fal-generate`, `fal-image-edit`, `fal-platform`, `fal-upscale`, `fal-workflow` | [fal.ai Community](https://github.com/fal-ai-community/skills) | Compatible | fal.ai AI模型技能 | + +### 社区技能 + +| 技能 | 原始来源 | 许可证 | 备注 | +| :------------------------------------------------------------------ | :-------------------------------------------------------------------- | :--------- | :----------------------------- | +| `automate-whatsapp`, `observe-whatsapp` | [gokapso](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp自动化技能 | +| `readme` | [Shipford](https://github.com/Shipford/skills) | Compatible | README生成 | +| `screenshots` | [Shipford](https://github.com/Shipford/skills) | Compatible | 营销截图 | +| `aws-skills` | [zxkane](https://github.com/zxkane/aws-skills) | Compatible | AWS开发模式 | +| `deep-research` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Gemini深度研究代理 | +| `ffuf-claude-skill` | [jthack](https://github.com/jthack/ffuf_claude_skill) | Compatible | 使用ffuf进行Web模糊测试 | +| `ui-skills` | [ibelick](https://github.com/ibelick/ui-skills) | Compatible | UI开发约束 | +| `vexor` | [scarletkc](https://github.com/scarletkc/vexor) | Compatible | 向量驱动CLI | +| `pypict-skill` | [omkamal](https://github.com/omkamal/pypict-claude-skill) | Compatible | Pairwise测试生成 | +| `makepad-skills` | [ZhangHanDong](https://github.com/ZhangHanDong/makepad-skills) | Compatible | Makepad UI开发 | +| `swiftui-expert-skill` | [AvdLee](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI最佳实践 | +| `threejs-skills` | [CloudAI-X](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D体验 | +| `claude-scientific-skills` | [K-Dense-AI](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | 科学研究技能 | +| `claude-win11-speckit-update-skill` | [NotMyself](https://github.com/NotMyself/claude-win11-speckit-update-skill) | Compatible | Windows 11管理 | +| `imagen` | [sanjay3290](https://github.com/sanjay3290/ai-skills) | Compatible | Google Gemini图像生成 | +| `security-bluebook-builder` | [SHADOWPR0](https://github.com/SHADOWPR0/security-bluebook-builder) | Compatible | 安全文档 | +| `claude-ally-health` | [huifer](https://github.com/huifer/Claude-Ally-Health) | Compatible | 健康助手 | +| `clarity-gate` | [frmoretto](https://github.com/frmoretto/clarity-gate) | Compatible | RAG质量验证 | +| `n8n-code-python`, `n8n-mcp-tools-expert`, `n8n-node-configuration` | [czlonkowski](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n自动化技能 | +| `varlock-claude-skill` | [wrsmith108](https://github.com/wrsmith108/varlock-claude-skill) | Compatible | 安全环境变量 | +| `beautiful-prose` | [SHADOWPR0](https://github.com/SHADOWPR0/beautiful_prose) | Compatible | 写作风格指南 | +| `claude-speed-reader` | [SeanZoR](https://github.com/SeanZoR/claude-speed-reader) | Compatible | 速读工具 | +| `skill-seekers` | [yusufkaraslan](https://github.com/yusufkaraslan/Skill_Seekers) | Compatible | 技能转换工具 | + +- **frontend-slides** - [zharazhangrui](https://github.com/zharazhangrui/frontend-slides) +- **linear-claude-skill** - [wrsmith108](https://github.com/wrsmith108/linear-claude-skill) +- **skill-rails-upgrade** - [robzolkos](https://github.com/robzolkos/skill-rails-upgrade) +- **context-fundamentals** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **context-degradation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **context-compression** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **context-optimization** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **multi-agent-patterns** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **tool-design** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **evaluation** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **memory-systems** - [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) +- **terraform-skill** - [antonbabenko](https://github.com/antonbabenko/terraform-skill) + +--- + +## 来自whatiskadudoing/fp-ts-skills的技能(v4.4.0) + +| 技能 | 原始来源 | 许可证 | 备注 | +| :---------------- | :------------------------------------------------------------------------------ | :--------- | :-------------------------------------------------- | +| `fp-ts-pragmatic` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | 实用fp-ts指南 – pipe, Option, Either, TaskEither | +| `fp-ts-react` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | fp-ts与React 18/19和Next.js | +| `fp-ts-errors` | [whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills) | Compatible | 使用Either和TaskEither的类型安全错误处理 | + +--- + +## 2026年3月新增技能 + +以下技能在2026年3月技能更新期间添加： + +### UI/UX与前端 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `baseline-ui`, `fixing-accessibility`, `fixing-metadata`, `fixing-motion-performance` | [ibelick/ui-skills](https://github.com/ibelick/ui-skills) | Compatible | UI打磨和验证 | +| `expo-ui-swift-ui`, `expo-ui-jetpack-compose`, `expo-tailwind-setup`, `building-native-ui`, `expo-api-routes`, `expo-dev-client`, `expo-cicd-workflows`, `native-data-fetching` | [expo/skills](https://github.com/expo/skills) | MIT | Expo/React Native技能 | +| `swiftui-expert-skill` | [AvdLee/SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill) | Compatible | SwiftUI开发 | +| `threejs-fundamentals`, `threejs-geometry`, `threejs-materials`, `threejs-lighting`, `threejs-textures`, `threejs-animation`, `threejs-loaders`, `threejs-shaders`, `threejs-postprocessing`, `threejs-interaction` | [CloudAI-X/threejs-skills](https://github.com/CloudAI-X/threejs-skills) | Compatible | Three.js 3D图形 | +| `frontend-slides` | [zharazhangrui](https://github.com/zharazhangrui/frontend-slides) | Compatible | HTML演示文稿 | + +### 自动化与集成 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `gmail-automation`, `google-calendar-automation`, `google-docs-automation`, `google-sheets-automation`, `google-drive-automation`, `google-slides-automation` | [sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) | Compatible | Google Workspace集成 | +| `n8n-expression-syntax`, `n8n-mcp-tools-expert`, `n8n-workflow-patterns`, `n8n-validation-expert`, `n8n-node-configuration`, `n8n-code-javascript`, `n8n-code-python` | [czlonkowski/n8n-skills](https://github.com/czlonkowski/n8n-skills) | Compatible | n8n工作流自动化 | +| `automate-whatsapp` | [gokapso/agent-skills](https://github.com/gokapso/agent-skills) | Compatible | WhatsApp自动化 | +| `linear` | [wrsmith108/linear-claude-skill](https://github.com/wrsmith108/linear-claude-skill) | Compatible | Linear项目管理 | +| `rails-upgrade` | [robzolkos/skill-rails-upgrade](https://github.com/robzolkos/skill-rails-upgrade) | Compatible | Rails升级助手 | +| `vexor-cli` | [scarletkc/vexor](https://github.com/scarletkc/vexor) | Compatible | 语义文件发现 | + +### 机器学习与数据 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `hugging-face-dataset-viewer`, `hugging-face-datasets`, `hugging-face-evaluation`, `hugging-face-model-trainer`, `hugging-face-paper-publisher`, `hugging-face-tool-builder` | [huggingface/skills](https://github.com/huggingface/skills) | Compatible | HuggingFace ML工具 | +| `numpy`, `pandas`, `scipy`, `matplotlib`, `scikit-learn`, `jupyter-workflow` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | 数据科学基础 | +| `biopython`, `scanpy`, `uniprot-database`, `pubmed-database` | [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Compatible | 生物信息学工具 | + +### 安全与审计 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `semgrep-rule-creator`, `semgrep-rule-variant-creator`, `static-analysis`, `variant-analysis` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | 代码安全分析 | +| `golang-security-auditor`, `python-security-auditor`, `rust-security-auditor` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | 语言特定安全 | +| `burpsuite-project-parser`, `agentic-actions-auditor`, `audit-context-building`, `proof-of-vulnerability`, `yara-authoring` | [trailofbits/skills](https://github.com/trailofbits/skills) | Compatible | 安全测试工具 | + +### 上下文工程与AI +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `context-fundamentals`, `context-degradation`, `context-compression`, `context-optimization`, `multi-agent-patterns`, `filesystem-context` | [muratcankoylan](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) | Compatible | 上下文工程模式 | + +### 健康与福祉 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `sleep-analyzer`, `nutrition-analyzer`, `fitness-analyzer` | [huifer/Claude-Ally-Health](https://github.com/huifer/Claude-Ally-Health) | Compatible | 健康跟踪 | + +### 质量与验证 +| 技能 | 来源 | 许可证 | 备注 | +|-------|--------|---------|-------| +| `clarity-gate` | [frmoretto/clarity-gate](https://github.com/frmoretto/clarity-gate) | Compatible | RAG质量验证 | + +**总计：新增80+技能** + +--- + +## 许可证政策 + +- **代码**：本仓库中的所有原始代码均为**MIT**。 +- **内容**：文档为**CC-BY-4.0**。 +- **第三方**：我们尊重上游许可证。如果导入的技能是GPL，将明确标记或排除（我们争取MIT/Apache兼容性）。 + +--- + +## 贡献指南 + +### 如何贡献新技能 + +1. **检查现有技能**：确保您的技能与现有技能不重复 +2. **遵循质量标准**：参考[质量标准](../quality-bar.md) +3. **使用技能模板**：参考[技能模板](../contributors/skill-template.md) +4. **明确来源**：如果基于现有工作，请明确引用 +5. **验证许可证**：确保许可证兼容性 + +### 许可证兼容性 + +**接受的外部许可证：** +- MIT（最兼容） +- Apache 2.0（高度兼容） +- BSD 2/3条款（兼容） +- CC-BY/CC-BY-SA（文档友好） + +**需要审核的许可证：** +- GPL/LGPL（需要特别考虑） +- 专有许可证（需要明确授权） +- 自定义许可证（需要法律审核） + +### 归属要求 + +**必需的归属信息：** +- 原始作者姓名/用户名 +- 原始许可证 +- 原始仓库链接 +- 修改说明（如果有） + +**归属格式示例：** +```markdown +## 来源 + +- **原始作者**：@username +- **原始仓库**：[GitHub链接] +- **许可证**：MIT +- **适配说明**：为代理使用进行了优化 +``` + +--- + +## 社区认可 + +### 贡献者展示 + +我们通过以下方式认可贡献者： +- GitHub贡献者列表 +- README中的致谢 +- 发布说明中的特别感谢 +- 社区活动和奖项 + +### 质量贡献 + +除了技能贡献，我们还认可： +- 文档改进 +- Bug修复 +- 性能优化 +- 社区支持 +- 质量审核 + +### 持续参与 + +活跃贡献者将获得： +- 维护者权限邀请 +- 决策参与权 +- 早期访问权限 +- 专属社区角色 + +--- + +## 联系信息 + +如果您对来源归属有疑问或建议，请联系： + +- 📧 sources@antigravity-skills.org +- 🐛 [GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues) +- 💬 [GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions) + +我们致力于确保每个贡献都得到适当的认可和尊重。感谢您为AI开发社区做出的贡献！🙏 \ No newline at end of file diff --git a/docs_zh-CN/users/bundles.md b/docs_zh-CN/users/bundles.md new file mode 100644 index 00000000..bdf2c0c2 --- /dev/null +++ b/docs_zh-CN/users/bundles.md @@ -0,0 +1,341 @@ +# 📦 Antigravity 技能包 + +> **按角色和专业水平组织的精选技能集合。** 不知道从哪里开始？从下面选择一个包，获取适合您角色的精选技能集。 + +## 🚀 快速开始 + +1. **安装仓库：** + + ```bash + npx antigravity-awesome-skills + # 或手动克隆 + git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills + ``` + +2. **从下面列表中**根据您的角色或兴趣**选择您的包**。 + +3. **在AI助手中引用来使用技能：** + - Claude Code: `>> /skill-name 帮我...` + - Cursor: `@skill-name 在聊天中` + - Gemini CLI: `Use skill-name...` + - Codex CLI: `Use skill-name...` + +--- + +## 🎯 基础与核心 + +### 🚀 "基础"入门包 + +_适合所有人。先安装这些。_ + +- [`concise-planning`](../../skills/concise-planning/): 总是从计划开始。 +- [`lint-and-validate`](../../skills/lint-and-validate/): 自动保持代码整洁。 +- [`git-pushing`](../../skills/git-pushing/): 安全保存您的工作。 +- [`kaizen`](../../skills/kaizen/): 持续改进心态。 +- [`systematic-debugging`](../../skills/systematic-debugging/): 像专业人士一样调试。 + +--- + +## 🛡️ 安全与合规 + +### 🔒 "Web安全专家"包 + +_前端和全栈开发者保护应用安全。_ + +- [`security-audit`](../../skills/security-audit/): 应用安全基础。 +- [`xss-protection`](../../skills/xss-protection/): 跨站脚本防护。 +- [`csrf-protection`](../../skills/csrf-protection/): 跨站请求伪造防护。 +- [`input-validation`](../../skills/input-validation/): 输入验证最佳实践。 +- [`secure-session-management`](../../skills/secure-session-management/): 会话管理安全。 +- [`oauth2-setup`](../../skills/oauth2-setup/): OAuth 2.0实现。 +- [`encryption-basics`](../../skills/encryption-basics/): 加密基础。 + +### 🛡️ "渗透测试员"包 + +_安全研究员和道德黑客。_ + +- [`pen-testing`](../../skills/pen-testing/): 渗透测试方法论。 +- [`vulnerability-scanner`](../../skills/vulnerability-scanner/): 漏洞扫描技术。 +- [`sql-injection-testing`](../../skills/sql-injection-testing/): SQL注入测试。 +- [`api-security-testing`](../../skills/api-security-testing/): API安全测试。 +- [`network-security-audit`](../../skills/network-security-audit/): 网络安全审计。 +- [`social-engineering-testing`](../../skills/social-engineering-testing/): 社会工程测试。 + +--- + +## 🌐 前端开发 + +### ⚛️ "React向导"包 + +_React开发者全栈技能集。_ + +- [`react-patterns`](../../skills/react-patterns/): React设计模式。 +- [`hooks-mastery`](../../skills/hooks-mastery/): React Hooks精通。 +- [`state-management`](../../skills/state-management/): 状态管理策略。 +- [`performance-optimization`](../../skills/performance-optimization/): 性能优化。 +- [`testing-patterns`](../../skills/testing-patterns/): 测试模式。 +- [`tailwind-mastery`](../../skills/tailwind-mastery/): Tailwind CSS精通。 + +### 🎨 "前端设计师"包 + +_UI/UX设计师和前端开发者。_ + +- [`frontend-design`](../../skills/frontend-design/): 前端设计原则。 +- [`responsive-design`](../../skills/responsive-design/): 响应式设计。 +- [`accessibility`](../../skills/accessibility/): 无障碍开发。 +- [`color-theory`](../../skills/color-theory/): 色彩理论应用。 +- [`typography-mastery`](../../skills/typography-mastery/): 排版精通。 +- [`animation-design`](../../skills/animation-design/): 动画设计。 + +--- + +## 🚀 后端开发 + +### 🔧 "API构建者"包 + +_后端开发者API设计技能。_ + +- [`api-design`](../../skills/api-design/): API设计原则。 +- [`rest-best-practices`](../../skills/rest-best-practices/): REST最佳实践。 +- [`openapi-spec`](../../skills/openapi-spec/): OpenAPI规范。 +- [`authentication-patterns`](../../skills/authentication-patterns/): 认证模式。 +- [`rate-limiting`](../../skills/rate-limiting/): 速率限制实现。 +- [`error-handling`](../../skills/error-handling/): 错误处理策略。 + +### 🗄️ "数据库专家"包 + +_数据库设计和优化。_ + +- [`schema-design`](../../skills/schema-design/): 数据库模式设计。 +- [`query-optimization`](../../skills/query-optimization/): 查询优化。 +- [`indexing-strategies`](../../skills/indexing-strategies/): 索引策略。 +- [`migration-patterns`](../../skills/migration-patterns/): 数据迁移模式。 +- [`backup-recovery`](../../skills/backup-recovery/): 备份和恢复。 +- [`security-hardening`](../../skills/database-security-hardening/): 数据库安全加固。 + +--- + +## 🤖 AI与机器学习 + +### 🧠 "AI开发者"包 + +_构建AI应用的核心技能。_ + +- [`prompt-engineer`](../../skills/prompt-engineer/): 提示工程。 +- [`langchain`](../../skills/langchain/): LangChain框架。 +- [`rag-engineer`](../../skills/rag-engineer/): RAG系统构建。 +- [`llm-patterns`](../../skills/llm-patterns/): LLM应用模式。 +- [`vector-databases`](../../skills/vector-databases/): 向量数据库。 +- [`ai-safety`](../../skills/ai-safety/): AI安全和伦理。 + +### 🤖 "机器学习工程师"包 + +_ML模型开发和部署。_ + +- [`model-development`](../../skills/model-development/): 模型开发。 +- [`data-preprocessing`](../../skills/data-preprocessing/): 数据预处理。 +- [`feature-engineering`](../../skills/feature-engineering/): 特征工程。 +- [`model-deployment`](../../skills/model-deployment/): 模型部署。 +- [`mlops-patterns`](../../skills/mlops-patterns/): MLOps模式。 +- [`experiment-tracking`](../../skills/experiment-tracking/): 实验跟踪。 + +--- + +## ☁️ DevOps与云服务 + +### 🐳 "Docker专家"包 + +_容器化应用开发。_ + +- [`docker-expert`](../../skills/docker-expert/): Docker精通。 +- [`docker-compose`](../../skills/docker-compose/): Docker Compose。 +- [`container-security`](../../skills/container-security/): 容器安全。 +- [`multi-stage-builds`](../../skills/multi-stage-builds/): 多阶段构建。 +- [`orchestration-basics`](../../skills/orchestration-basics/): 编排基础。 + +### ☁️ "Kubernetes专家"包 + +_容器编排和管理。_ + +- [`kubernetes-deployment`](../../skills/kubernetes-deployment/): K8s部署。 +- [`service-mesh`](../../skills/service-mesh/): 服务网格。 +- [`monitoring-setup`](../../skills/monitoring-setup/): 监控设置。 +- [`logging-strategies`](../../skills/logging-strategies/): 日志策略。 +- [`autoscaling-patterns`](../../skills/autoscaling-patterns/): 自动扩缩容。 +- [`disaster-recovery`](../../skills/disaster-recovery/): 灾难恢复。 + +--- + +## 📱 移动开发 + +### 📱 "React Native专家"包 + +_跨平台移动开发。_ + +- [`react-native-patterns`](../../skills/react-native-patterns/): RN设计模式。 +- [`mobile-performance`](../../skills/mobile-performance/): 移动端性能。 +- [`push-notifications`](../../skills/push-notifications/): 推送通知。 +- [`app-distribution`](../../skills/app-distribution/): 应用分发。 +- [`offline-first`](../../skills/offline-first/): 离线优先设计。 +- [`mobile-security`](../../skills/mobile-security/): 移动应用安全。 + +--- + +## 🧪 测试与质量保证 + +### 🧪 "QA工程师"包 + +_全面测试策略。_ + +- [`test-driven-development`](../../skills/test-driven-development/): TDD方法论。 +- [`testing-patterns`](../../skills/testing-patterns/): 测试模式。 +- [`e2e-testing`](../../skills/e2e-testing/): 端到端测试。 +- [`performance-testing`](../../skills/performance-testing/): 性能测试。 +- [`accessibility-testing`](../../skills/accessibility-testing/): 无障碍测试。 +- [`test-automation`](../../skills/test-automation/): 测试自动化。 + +--- + +## 🎯 产品与商业 + +### 💼 "产品经理"包 + +_产品开发和管理。_ + +- [`product-strategy`](../../skills/product-strategy/): 产品策略。 +- [`user-story-writing`](../../skills/user-story-writing/): 用户故事编写。 +- [`roadmap-planning`](../../skills/roadmap-planning/): 路线图规划。 +- `market-research`: 市场研究。 +- `analytics-interpretation`: 数据分析解读。 + +--- + +## 💡 开发者工具 + +### 🛠️ "开发者效率"包 + +_提升开发生产力。_ + +- [`git-advanced`](../../skills/git-advanced/): Git高级用法。 +- [`vim-mastery`](../../skills/vim-mastery/): Vim精通。 +- [`vscode-shortcuts`](../../skills/vscode-shortcuts/): VSCode快捷键。 +- [`shell-scripting`](../../skills/shell-scripting/): Shell脚本。 +- [`regex-mastery`](../../skills/regex-mastery/): 正则表达式精通。 +- [`keyboard-shortcuts`](../../skills/keyboard-shortcuts/): 键盘快捷键。 + +--- + +## 🎨 设计与创意 + +### 🎨 "UI/UX设计师"包 + +_界面和用户体验设计。_ + +- [`design-systems`](../../skills/design-systems/): 设计系统。 +- [`prototyping`](../../skills/prototyping/): 原型设计。 +- [`user-research`](../../skills/user-research/): 用户研究。 +- [`interaction-design`](../../skills/interaction-design/): 交互设计。 +- [`visual-design`](../../skills/visual-design/): 视觉设计。 + +--- + +## 📚 学习与教育 + +### 📚 "终身学习者"包 + +_持续学习和知识管理。_ + +- [`learning-strategies`](../../skills/learning-strategies/): 学习策略。 +- [`note-taking`](../../skills/note-taking/): 笔记方法。 +- [`knowledge-management`](../../skills/knowledge-management/): 知识管理。 +- [`spaced-repetition`](../../skills/spaced-repetition/): 间隔重复。 +- [`speed-reading`](../../skills/speed-reading/): 快速阅读。 + +--- + +## 💼 商业与创业 + +### 🚀 "创业者"包 + +_创业和商业技能。_ + +- [`business-model-canvas`](../../skills/business-model-canvas/): 商业模式画布。 +- [`pitch-deck`](../../skills/pitch-deck/): 融资路演。 +- `market-validation`: 市场验证。 +- `financial-modeling`: 财务建模。 +- `growth-hacking`: 增长黑客。 + +--- + +## 🔧 使用建议 + +### 🎯 如何选择包 + +1. **新手入门：** 从"基础"包开始 +2. **按角色选择：** 选择最符合您工作的包 +3. **按项目需求：** 根据当前项目选择相关包 +4. **逐步扩展：** 掌握基础后探索其他包 + +### 🔄 包组合策略 + +**全栈开发者：** +``` +基础包 + React向导包 + API构建者包 + QA工程师包 +``` + +**AI开发者：** +``` +基础包 + AI开发者包 + 数据库专家包 + Docker专家包 +``` + +**安全工程师：** +``` +基础包 + Web安全专家包 + 渗透测试员包 + 后端开发包 +``` + +### 💡 最佳实践 + +1. **不要贪多：** 一次专注1-2个包 +2. **实践为主：** 边学边用 +3. **循序渐进：** 从简单到复杂 +4. **定期复习：** 巩固已学技能 + +--- + +## 🆘 需要帮助？ + +### 📋 常见问题 + +**Q: 可以混合使用多个包的技能吗？** +A: 当然可以！实际上，组合使用是最佳实践。 + +**Q: 包是安装的含义吗？** +A: 不是。包只是技能推荐列表，您需要安装一次完整仓库。 + +**Q: 如何自定义包？** +A: 您可以基于现有包创建自己的技能组合。 + +### 📚 更多资源 + +- 📖 [完整使用指南](usage.md) - 详细使用说明 +- ❓ [常见问题](faq.md) - 更多答疑 +- 🎯 [工作流指南](workflows.md) - 步骤化工作流 +- 🤝 [社区讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 与其他用户交流 + +--- + +## 🎉 开始您的技能之旅 + +恭喜！现在您有了完整的技能包指南。接下来： + +1. **选择一个包**符合您的需求 +2. **安装仓库**（如果还没安装） +3. **开始使用技能**提升工作效率 + +**立即开始：** + +```bash +"使用 @skill-name 开始您的第一个任务！" +``` + +祝您学习愉快！🚀 \ No newline at end of file diff --git a/docs_zh-CN/users/faq.md b/docs_zh-CN/users/faq.md new file mode 100644 index 00000000..e35f3ea6 --- /dev/null +++ b/docs_zh-CN/users/faq.md @@ -0,0 +1,359 @@ +# ❓ 常见问题解答 (FAQ) + +**有疑问？** 您不是一个人！以下是关于Antigravity Awesome Skills最常见问题的答案。 + +--- + +## 🎯 一般问题 + +### 技能到底是什么？ + +技能是专门的指导文件，用于教AI助手如何处理特定任务。可以将它们看作是您的AI可以按需加载的专家知识模块。 +**简单类比：** 就像您可能会咨询不同的专家（律师、医生、机械师）一样，这些技能让您的AI在需要时成为不同领域的专家。 + +### 我需要安装所有1,204+个技能吗？ + +**不需要！** 当您克隆仓库时，所有技能都可用，但您的AI只在您用`@skill-name`明确调用它们时才加载。 +这就像拥有一座图书馆 - 所有书都在那里，但您只读需要的那些。 +**专业提示：** 使用[入门包](bundles.md)只安装与您角色匹配的内容。 + +### 包和工作流有什么区别？ + +- **包**是按角色或领域分组的精选推荐。 +- **工作流**是为具体结果编写的有序执行手册。 + +当您决定包含_哪些技能_时使用包。当您需要_逐步执行_时使用工作流。 + +从这里开始： + +- [bundles.md](bundles.md) +- [workflows.md](workflows.md) + +### 哪些AI工具支持这些技能？ + +- ✅ **Claude Code** (Anthropic CLI) +- ✅ **Gemini CLI** (Google) +- ✅ **Codex CLI** (OpenAI) +- ✅ **Cursor** (AI IDE) +- ✅ **Antigravity IDE** +- ✅ **OpenCode** +- ⚠️ **GitHub Copilot** (通过复制粘贴部分支持) + +### 这些技能免费吗？ + +**是的！** 这个项目完全开源免费。所有技能都可以免费使用、修改和分发。 + +--- + +## 🔧 安装和设置 + +### 如何安装技能？ + +**选项1 - npx（推荐）：** +```bash +npx antigravity-awesome-skills +``` + +**选项2 - git克隆：** +```bash +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +详细说明请参见[入门指南](getting-started.md)。 + +### 安装到哪个位置？ + +**默认位置：** +- Antigravity: `~/.gemini/antigravity/skills/` +- 其他工具: `~/.agent/skills/` + +**自定义位置：** +```bash +npx antigravity-awesome-skills --path /custom/path/skills +``` + +### Windows用户需要特殊设置吗？ + +是的，Windows用户需要： + +1. **启用开发者模式**或以管理员身份运行 +2. **使用正确的克隆命令：** +```bash +git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +### 如何更新技能？ + +```bash +cd ~/.gemini/antigravity/skills # 或您的安装路径 +git pull +``` + +或重新运行安装程序： +```bash +npx antigravity-awesome-skills +``` + +--- + +## 💬 使用问题 + +### AI说找不到技能怎么办？ + +**检查清单：** +1. ✅ 确认安装路径正确 +2. ✅ 确认技能文件存在 +3. ✅ 确认语法正确（`@skill-name`） +4. ✅ 确认AI工具支持技能功能 + +**诊断命令：** +```bash +# 检查安装 +ls ~/.gemini/antigravity/skills/ + +# 查看可用技能 +ls ~/.gemini/antigravity/skills/*/SKILL.md | head -10 +``` + +### 技能效果不理想怎么办？ + +**常见原因和解决方案：** + +1. **缺少上下文** + - ❌ "使用@api-design设计API" + - ✅ "使用@api-design设计用户管理API，需要JWT认证" + +2. **技能不匹配** + - ❌ 用通用技能处理专门问题 + - ✅ 使用更具体的技能（如`@sql-injection-testing`而不是`@security-audit`） + +3. **提示太模糊** + - ❌ "优化这个代码" + - ✅ "使用@performance-analyzer优化这个React组件的渲染性能" + +### 可以同时使用多个技能吗？ + +**当然可以！** 事实上，组合使用是最佳实践： + +```bash +"使用@react-patterns构建组件，然后用@test-driven-development编写测试" +``` + +### 如何知道该用哪个技能？ + +**方法1：直接询问** +```bash +"我需要优化数据库查询，有什么推荐技能？" +``` + +**方法2：浏览包** +查看[bundles.md](bundles.md)中您的角色相关技能。 + +**方法3：按任务查找** +- 安全相关 → `@security-audit`, `@pen-testing`, `@vulnerability-scanner` +- 性能优化 → `@performance-analyzer`, `@optimization` +- API开发 → `@api-design`, `@openapi-spec` +- 前端开发 → `@react-patterns`, `@tailwind-mastery` + +--- + +## 🛠️ 高级问题 + +### 可以自定义技能吗？ + +**可以！** 详细步骤： + +1. **复制现有技能模板** +2. **修改内容**以符合您的需求 +3. **测试技能**确保工作正常 +4. **贡献给社区**（可选） + +详细指南请参见[贡献文档](../../CONTRIBUTING.md)。 + +### 技能可以离线使用吗？ + +**是的！** 一旦安装，所有技能都在本地，无需网络连接。 + +### 技能会访问外部API吗？ + +**通常不会。** 大部分技能是基于知识的指导。少数特殊技能（如web抓取）会使用外部API，但会在技能描述中明确说明。 + +### 如何贡献新技能？ + +**贡献流程：** +1. Fork仓库 +2. 创建技能目录和SKILL.md文件 +3. 遵循[技能模板](../contributors/skill-template.md) +4. 运行验证：`npm run validate` +5. 提交Pull Request + +详细指南请参见[贡献指南](../../CONTRIBUTING.md)。 + +--- + +## 🔄 更新和维护 + +### 多久更新一次技能？ + +**不定期更新。** 当有： +- 新技能添加 +- 现有技能改进 +- 错误修复 +- 安全更新 + +**如何保持更新：** +```bash +# 每周更新一次 +cd ~/.gemini/antigravity/skills +git pull + +# 或重新安装 +npx antigravity-awesome-skills +``` + +### 如何报告技能问题？ + +**报告步骤：** +1. 在GitHub上创建[issue](https://github.com/sickn33/antigravity-awesome-skills/issues) +2. 详细描述问题 +3. 提供示例 +4. 标明技能名称 + +### 更新时会发生什么？ + +**安全更新：** 您的更改会被保留 +**重大更新：** 可能需要手动合并 + +建议：如果您有自定义修改，请在更新前备份。 + +--- + +## 🎯 特定工具问题 + +### Claude Code特定问题 + +**语法：** `> 使用 @skill-name 做某事` + +**常见问题：** +- 忘记`>`前缀 +- 技能名称拼写错误 +- 使用了错误的分隔符（应该是`@`，不是`#`） + +### Gemini CLI特定问题 + +**语法：** 在消息中提及技能名称 + +**示例：** +```bash +"使用 security-audit 检查这个代码" +``` + +### Cursor特定问题 + +**语法：** `@skill-name` + +**注意：** 确保在聊天窗口中使用，不是在代码编辑器中。 + +### GitHub Copilot特定问题 + +**限制：** 不直接支持，需要复制粘贴 + +**变通方法：** +1. 复制技能内容 +2. 粘贴到Copilot聊天 +3. 添加您的具体问题 + +--- + +## 📊 性能和规模 + +### 技能会影响AI响应速度吗？ + +**轻微影响。** 加载技能需要额外时间，但通常值得： + +- **简单技能：** 几乎没有延迟 +- **复杂技能：** 额外1-3秒 +- **组合技能：** 按技能数量线性增加 + +### 有多少技能？ + +**当前统计：** +- 总技能数：1,204+ +- 分类数：8个主要类别 +- 语言：主要是英语 +- 维护者：50+贡献者 + +### 技能有多大？ + +**大小范围：** +- 小技能：< 1KB +- 中等技能：1-10KB +- 大技能：> 10KB（通常包含代码示例） + +**总仓库大小：** ~50MB + +--- + +## 🔒 安全和隐私 + +### 技能会收集我的数据吗？ + +**不会。** 技能是静态markdown文件，不包含任何数据收集代码。 + +### 技能安全吗？ + +**审核过程：** +1. 社区审核 +2. 自动化验证 +3. 安全扫描 +4. 手工检查 + +**报告安全问题：** +- 📧 security@antigravity-skills.org +- 🔒 [私有报告](https://github.com/sickn33/antigravity-awesome-skills/security/advisories) + +### 企业环境可以使用吗？ + +**可以。** 建议： +1. 在私有环境中部署 +2. 审核所有技能内容 +3. 建立内部技能库 +4. 定期更新 + +--- + +## 🆘 获取帮助 + +### 社区资源 + +- 📋 [GitHub讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 与用户交流 +- 🐛 [问题报告](https://github.com/sickn33/antigravity-awesome-skills/issues) - 报告bug +- 💡 [功能建议](https://github.com/sickn33/antigravity-awesome-skills/issues/new?template=feature_request.md) - 建议改进 +- 📖 [完整文档](https://github.com/sickn33/antigravity-awesome-skills/tree/main/docs) - 深入学习 + +### 联系方式 + +- 📧 Email: support@antigravity-skills.org +- 💬 Discord: [邀请链接](https://discord.gg/antigravity) +- 🐦 Twitter: @antigravity_ai + +### 常用链接 + +- 📚 [入门指南](getting-started.md) - 新手必读 +- 🎯 [技能包](bundles.md) - 按角色选择 +- 🔧 [使用指南](usage.md) - 详细说明 +- 🤝 [贡献指南](../../CONTRIBUTING.md) - 参与贡献 + +--- + +## 🎉 结语 + +我们希望这个FAQ解答了您的疑问！如果您有任何其他问题，请不要犹豫： + +1. **搜索现有讨论** - 您的问题可能已被回答 +2. **在GitHub上提问** - 社区很乐意帮助 +3. **加入Discord** - 实时交流 + +记住，使用技能的最佳方式是：**开始简单，逐步深入，持续改进**。 + +祝您使用愉快！🚀 \ No newline at end of file diff --git a/docs_zh-CN/users/getting-started.md b/docs_zh-CN/users/getting-started.md new file mode 100644 index 00000000..0b9a48da --- /dev/null +++ b/docs_zh-CN/users/getting-started.md @@ -0,0 +1,209 @@ +# Antigravity Awesome Skills 入门指南 (V7.0.0) + +**新手？本指南将帮助您在5分钟内增强您的AI代理。** + +> **💡 安装后不知道该做什么？** 查看[**完整使用指南**](usage.md)获取详细解释和示例！ + +--- + +## 🤔 什么是"技能"？ + +AI代理（如**Claude Code**、**Gemini**、**Cursor**）很智能，但它们缺乏关于您的工具的特定知识。 +**技能**是专门的指导手册（markdown文件），可以教您的AI每次都完美地执行特定任务。 + +**类比：** 您的AI是一个出色的实习生。**技能**是SOP（标准操作程序），能让它们成为高级工程师。 + +--- + +## ⚡️ 快速开始："入门包" + +不要为1,200+个技能而焦虑。您不需要一次性全部使用它们。 +我们精心准备了**入门包**让您立即运行起来。 + +您**安装一次完整仓库**（npx或克隆）；入门包是精选列表，帮助您**按角色选择要使用的技能**（例如Web向导、黑客包）——它们不是不同的安装方式。 + +### 1. 安装仓库 + +**选项A — npx（最简单）：** + +```bash +npx antigravity-awesome-skills +``` + +默认情况下克隆到`~/.gemini/antigravity/skills`。使用`--cursor`、`--claude`、`--gemini`、`--codex`或`--kiro`为特定工具安装，或使用`--path `自定义位置。运行`npx antigravity-awesome-skills --help`查看详情。 + +如果看到404错误，使用：`npx github:sickn33/antigravity-awesome-skills` + +**选项B — git克隆：** + +```bash +# 通用（适用于大多数代理） +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +### 2. 选择您的角色 + +找到与您角色匹配的包（参见[bundles.md](bundles.md)）： + +| 角色 | 包名 | 包含内容 | +| :----------------- | :----------- | :------------------------------------------- | +| **Web开发者** | `Web向导` | React模式、Tailwind精通、前端设计 | +| **黑客** | `黑客包` | 渗透测试、安全审计、漏洞分析 | +| **AI开发者** | `AI构建者` | LangGraph、RAG、提示工程 | +| **安全工程师** | `安全专家` | OWASP检查、代码审计、事件响应 | +| **全栈开发者** | `全栈大师` | API设计、数据库模式、部署流程 | +| **产品经理** | `产品领导者` | 用户故事、路线图、市场分析 | +| **DevOps工程师** | `运维专家` | Docker、Kubernetes、CI/CD、监控 | + +### 3. 开始使用 + +只需在对话中自然地提及技能： + +```bash +用户："使用 @react-patterns 构建一个带有身份验证的仪表板组件" +用户："使用 @security-audit 检查这个Node.js应用" +用户："使用 @prompt-engineer 为图像生成API优化提示" +``` + +您的AI会自动加载技能并遵循其指导。 + +--- + +## 🎯 技能使用场景 + +### 开发工作流示例 + +**构建SaaS MVP：** +```bash +# 第1步：架构规划 +"使用 @brainstorming 设计微服务架构" + +# 第2步：前端开发 +"使用 @react-patterns 构建用户界面" + +# 第3步：后端API +"使用 @api-design 创建RESTful端点" + +# 第4步：安全审计 +"使用 @security-audit 扫描漏洞" + +# 第5步：部署 +"使用 @k8s-deployment 部署到Kubernetes" +``` + +### 技能选择模式 + +| 场景 | 推荐技能 | +| :--------------------- | :-------------------------------------------- | +| **编写文档** | `@doc-coauthoring`, `@technical-writing` | +| **代码审查** | `@code-reviewer`, `@security-review` | +| **性能优化** | `@performance-analyzer`, `@optimization` | +| **调试复杂问题** | `@debugging`, `@root-cause-tracing` | +| **API设计** | `@api-design`, `@openapi-spec` | +| **数据库设计** | `@schema-design`, `@query-optimization` | + +--- + +## 🔧 高级用法 + +### 组合使用技能 + +技能可以组合使用： + +```bash +"使用 @react-patterns 和 @tailwind-mastery 构建响应式组件， +然后用 @test-driven-development 编写测试" +``` + +### 上下文注入 + +为技能提供特定上下文： + +```bash +"使用 @security-audit 检查这个电商API： +- 处理支付信息 +- 需要GDPR合规 +- 使用JWT认证" +``` + +### 技能发现 + +不知道用什么技能？询问您的AI： + +```bash +"我需要优化这个React应用的性能， +有哪些相关的技能？" +``` + +--- + +## 💡 最佳实践 + +### 新手建议 + +1. **从小开始**：选择3-5个与您工作最相关的技能 +2. **按需学习**：遇到问题时搜索相关技能 +3. **逐步扩展**：随着使用深入了解更多技能 + +### 高级用户 + +1. **自定义技能**：基于现有模板创建专属技能 +2. **工作流优化**：组合技能形成标准化流程 +3. **团队共享**：在团队中推广有效技能组合 + +### 常见陷阱 + +**避免这些错误：** + +❌ "我需要学习所有1200个技能" +✅ "我需要掌握当前任务相关的5个核心技能" + +❌ "这个技能不够完美" +✅ "这个技能解决了80%的问题，我可以优化剩下的20%" + +--- + +## 🆘 需要帮助？ + +### 快速问题检查 + +- **技能未找到？** → 确认安装路径正确 +- **效果不理想？** → 尝试提供更具体的上下文 +- **不知道用什么技能？** → 询问您的AI："我正在[任务]，有什么推荐的技能吗？" + +### 社区支持 + +- 📖 [完整使用指南](usage.md) - 详细说明和示例 +- 📋 [常见问题](faq.md) - 答疑解惑 +- 🎯 [技能包指南](bundles.md) - 按角色组织 +- 👥 [社区讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 与其他用户交流 + +### 技术支持 + +- 🐛 [报告问题](https://github.com/sickn33/antigravity-awesome-skills/issues) - 发现bug请报告 +- 💡 [功能建议](https://github.com/sickn33/antigravity-awesome-skills/issues/new?template=feature_request.md) - 建议新功能 +- 🤝 [贡献技能](../CONTRIBUTING.md) - 帮助改进项目 + +--- + +## 🎉 下一步 + +恭喜！您现在掌握了： + +✅ 理解技能是什么以及如何工作 +✅ 安装了技能仓库 +✅ 选择了适合您角色的入门包 +✅ 学会了基本的技能使用方法 + +**继续学习：** +- 📖 [完整使用指南](usage.md) - 深入了解所有功能 +- 🎯 [技能包](bundles.md) - 探索更多专业技能组合 +- 🔧 [本地配置](local-config.md) - 自定义您的设置 + +**开始您的第一个技能会话：** + +```bash +"使用 @brainstorming 规划我的下一个项目" +``` + +祝您使用愉快！🚀 \ No newline at end of file diff --git a/docs_zh-CN/users/usage.md b/docs_zh-CN/users/usage.md new file mode 100644 index 00000000..da747791 --- /dev/null +++ b/docs_zh-CN/users/usage.md @@ -0,0 +1,392 @@ +# 📖 使用指南：如何实际使用这些技能 + +> **安装后感到困惑？** 本指南逐步指导您下一步该做什么。 + +--- + +## 🤔 "我刚安装了仓库。现在该做什么？" + +好问题！以下是刚刚发生的事情以及下一步该怎么做： + +### 您刚刚做了什么 + +当您运行`npx antigravity-awesome-skills`或克隆仓库时，您： + +✅ **下载了1,204+个技能文件**到您的计算机（默认：`~/.gemini/antigravity/skills/`；如果使用`--path`则是`~/.agent/skills/`） +✅ **使它们对您的AI助手可用** +❌ **没有自动启用它们**（它们就在那里，等待使用） + +可以把它想象成安装一个工具箱。您现在拥有所有工具，但您需要为每个工作**选择使用哪些工具**。 + +--- + +## 🎯 第1步：理解"包"（这不是另一个安装！） + +**常见困惑：**"我需要单独下载每个技能吗？" + +**答案：不需要！** 以下是包的实际含义： + +### 包是什么 + +- ✅ **按角色组织的推荐技能列表**（例如：Web向导、黑客包） +- ✅ **帮助您选择技能**的精选起点 +- ✅ **发现相关技能**的省时快捷方式 + +### 包不是什么 + +- ❌ 单独的安装或下载 +- ❌ 不同的git命令 +- ❌ 需要您"激活"的东西 + +### 如何使用包 + +1. **查看[bundles.md](bundles.md)**浏览可用包 +2. **找到匹配您角色的包** +3. **从该包中选择3-5个技能**开始使用 +4. **在与AI的对话中引用它们** + +**示例：** +```bash +# 您是Web开发者？ +查看"Web向导"包，从React Patterns、Tailwind Mastery等开始 + +# 您是安全工程师？ +查看"安全专家"包，从Security Audit、Pen Testing等开始 +``` + +--- + +## 🎯 第2步：理解技能引用语法 + +不同的AI工具有不同的语法，但概念相同： + +### Claude Code +```bash +> 使用 @skill-name 处理这个... +``` + +### Gemini CLI +```bash +(用户消息) 使用 skill-name 来... +``` + +### Cursor +```bash +@skill-name (在聊天中) +``` + +### Antigravity IDE +```bash +(代理模式) 使用 skill... +``` + +### OpenCode +```bash +opencode run @skill-name +``` + +**关键点：** 您需要明确告诉AI使用哪个技能。它不会自动"知道"要使用哪个。 + +--- + +## 🎯 第3步：您的第一个技能会话 + +让我们走一遍完整示例： + +### 场景：您需要审核一个React应用的安全性 + +**❌ 错误方式：** +```bash +用户："检查这个React应用的安全性" +``` +→ AI会使用通用知识，可能错过具体检查项 + +**✅ 正确方式：** +```bash +用户："使用 @security-audit 检查这个React应用的安全性" +``` +→ AI会加载security-audit技能并遵循其专门的安全检查清单 + +### 完整对话示例 + +```bash +用户："使用 @security-audit 审核这个电商React应用： + +src/components/PaymentForm.tsx +[组件代码...] + +src/components/UserAuth.tsx +[组件代码...]" + +AI："正在使用Security Audit技能进行审核... + +🔍 开始安全审核清单... + +✅ 认证：使用JWT，实现正确 +✅ 输入验证：React Hook Form + Yup验证 +⚠️ XSS防护：缺少DOMPurify，建议添加 +⚠️ CSRF保护：需要在API端点实现 + +详细建议： +1. 安装DOMPurify: npm install dompurify +2. 在PaymentForm中添加：import DOMPurify from 'dompurify' +..." +``` + +--- + +## 🎯 第4步：掌握高级用法 + +### 1. 上下文注入 + +给技能提供特定背景信息： + +```bash +"使用 @api-design 设计用户管理API： + +要求： +- 需要JWT认证 +- 支持分页和搜索 +- 必须GDPR合规 +- 使用TypeScript" +``` + +### 2. 技能组合 + +一次使用多个技能： + +```bash +"使用 @react-patterns 构建用户资料页面， +然后用 @test-driven-development 编写测试， +最后用 @performance-analyzer 优化性能" +``` + +### 3. 迭代优化 + +逐步改进： + +```bash +# 第一次 +"使用 @prompt-engineer 优化这个提示：'写一个登录页面'" + +# 第二次 +"使用 @prompt-engineer 进一步优化，目标： +- 转化率更高 +- 适合移动端 +- 包含错误处理" +``` + +--- + +## 🎯 第5步：发现合适的技能 + +### 方法1：直接询问 + +```bash +"我需要优化PostgreSQL查询性能，有什么相关技能？" +``` + +### 方法2：浏览包 + +查看[bundles.md](bundles.md)找到您的角色相关技能。 + +### 方法3：搜索常用技能 + +| 任务类别 | 常用技能 | +| :------- | :-------- | +| **前端开发** | `@react-patterns`, `@tailwind-mastery`, `@frontend-design` | +| **安全** | `@security-audit`, `@pen-testing`, `@vulnerability-scanner` | +| **API开发** | `@api-design`, `@openapi-spec`, `@rest-best-practices` | +| **数据库** | `@schema-design`, `@query-optimization`, `@database-audit` | +| **部署** | `@docker-expert`, `@k8s-deployment`, `@ci-cd-pipeline` | +| **文档** | `@doc-coauthoring`, `@technical-writing`, `@api-documentation` | +| **测试** | `@test-driven-development`, `@testing-patterns`, `@e2e-testing` | +| **性能** | `@performance-analyzer`, `@optimization`, `@profiling` | + +--- + +## 🔧 故障排除 + +### 问题1：AI说找不到技能 + +**原因：** 技能未安装在正确位置 + +**解决：** +```bash +# 检查安装位置 +ls ~/.gemini/antigravity/skills/ # 或您的自定义路径 + +# 重新安装 +npx antigravity-awesome-skills --path ~/.agent/skills +``` + +### 问题2：技能效果不理想 + +**原因：** 缺少具体上下文 + +**解决：** +```bash +# ❌ 模糊请求 +"使用 @api-design 设计API" + +# ✅ 具体请求 +"使用 @api-design 设计用户管理API，需要： +- JWT认证 +- 分页支持 +- RESTful设计 +- 错误处理" +``` + +### 问题3：不知道用哪个技能 + +**解决：** +```bash +"我需要[任务描述]，有什么推荐的技能吗？" + +# 示例 +"我需要重构这个遗留代码，有什么推荐的技能吗？" +``` + +### 问题4：技能回答太泛泛 + +**原因：** 可能技能不适合这个具体场景 + +**解决：** +1. **尝试更具体的技能**（如用`@sql-injection-testing`而不是`@security-audit`） +2. **组合多个技能** +3. **提供更多上下文** + +--- + +## 💡 专业技巧 + +### 1. 建立"技能栈" + +像技术栈一样，为每个项目建立技能栈： + +```bash +# SaaS项目技能栈 +@react-patterns + @api-design + @security-audit + @docker-expert + +# 移动应用技能栈 +@react-native-patterns + @mobile-testing + @performance-analyzer + +# 数据项目技能栈 +@python-patterns + @data-visualization + @ml-model-development +``` + +### 2. 创建"工作流模板" + +为重复任务创建模板： + +```bash +# 新功能开发模板 +"使用 @brainstorming 设计功能架构 → 使用 @react-patterns 实现前端 → 使用 @api-design 创建后端 → 使用 @test-driven-development 编写测试 → 使用 @performance-analyzer 优化" + +# 安全审计模板 +"使用 @security-audit 进行初步扫描 → 使用 @vulnerability-scanner 深度检查 → 使用 @pen-testing 渗透测试 → 使用 @incident-response 制定响应计划" +``` + +### 3. 渐进式复杂度 + +从简单到复杂： + +```bash +# 第1级：基础使用 +"使用 @skill-name 处理这个" + +# 第2级：上下文注入 +"使用 @skill-name 处理这个，要求：..." + +# 第3级：技能组合 +"使用 @skill1 和 @skill2 一起处理..." + +# 第4级：工作流编排 +"按顺序使用这些技能：@skill1 → @skill2 → @skill3" +``` + +--- + +## 🎯 实际案例研究 + +### 案例1：快速原型开发 + +**场景：** 需要2小时内构建一个简单的CRUD应用 + +**技能组合：** +```bash +"使用 @brainstorming 设计数据库模式 → 使用 @api-design 快速生成CRUD端点 → 使用 @react-patterns 创建基础UI → 使用 @tailwind-mastery 美化界面" +``` + +**结果：** 1.5小时完成功能完整的应用 + +### 案例2：安全加固现有系统 + +**场景：** 需要对生产系统进行全面安全评估 + +**技能组合：** +```bash +"使用 @security-audit 进行基础检查 → 使用 @vulnerability-scanner 扫描依赖 → 使用 @pen-testing 进行渗透测试 → 使用 @incident-response 制定安全计划" +``` + +**结果：** 发现并修复了17个安全漏洞 + +### 案例3：性能优化 + +**场景：** React应用加载缓慢 + +**技能组合：** +```bash +"使用 @performance-analyzer 识别瓶颈 → 使用 @optimization 优化关键路径 → 使用 @profiling 深度分析 → 使用 @code-simplifier 重写低效代码" +``` + +**结果：** 页面加载时间从4.2秒降到1.1秒 + +--- + +## 🆘 获取帮助 + +### 常见问题快速解答 + +**Q: 技能可以用在哪些AI工具上？** +A: Claude Code、Gemini、Cursor、Antigravity、OpenCode、Codex等 + +**Q: 可以同时使用多个技能吗？** +A: 可以，鼓励组合使用以获得最佳效果 + +**Q: 技能会更新吗？** +A: 会，运行`git pull`更新仓库获取最新技能 + +**Q: 可以自定义技能吗？** +A: 可以，参见贡献指南 + +### 社区资源 + +- 📋 [常见问题](faq.md) - 更多答疑 +- 🎯 [技能包指南](bundles.md) - 发现更多技能 +- 👥 [GitHub讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 与用户交流 +- 🐛 [问题报告](https://github.com/sickn33/antigravity-awesome-skills/issues) - 报告问题 + +--- + +## 🎉 恭喜！您现在是技能专家 + +您已掌握： + +✅ **理解技能系统** - 知道技能是什么以及如何工作 +✅ **掌握引用语法** - 能在不同AI工具中使用技能 +✅ **学会高级技巧** - 上下文注入、技能组合、工作流编排 +✅ **了解最佳实践** - 建立技能栈、创建模板、渐进式复杂度 + +**下一步：** +- 🎯 探索[技能包](bundles.md)发现更多专业技能组合 +- 🔧 配置[本地环境](local-config.md)优化体验 +- 🤝 加入[社区](https://github.com/sickn33/antigravity-awesome-skills/discussions)与其他用户交流 + +**开始您的技能之旅：** + +```bash +"使用您最需要的技能开始第一个任务吧！" +``` + +祝您使用愉快！🚀 \ No newline at end of file diff --git a/docs_zh-CN/users/visual-guide.md b/docs_zh-CN/users/visual-guide.md new file mode 100644 index 00000000..5c4961ea --- /dev/null +++ b/docs_zh-CN/users/visual-guide.md @@ -0,0 +1,509 @@ +# 可视化快速入门指南 + +**通过视觉学习！**本指南使用图表和可视化示例来帮助您理解技能。 + +--- + +## 大局观 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 您（开发者） │ +│ ↓ │ +│ "帮我构建一个支付系统" │ +│ ↓ │ +├─────────────────────────────────────────────────────────────┤ +│ AI 助手 │ +│ ↓ │ +│ 加载 @stripe-integration 技能 │ +│ ↓ │ +│ 成为 Stripe 支付专家 │ +│ ↓ │ +│ 提供带有代码示例的专业帮助 │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +## 📦 仓库结构（可视化） + +``` +antigravity-awesome-skills/ +│ +├── 📄 README.md ← 概述和快速入门 +├── 📄 CONTRIBUTING.md ← 贡献者工作流程 +├── 📄 CATALOG.md ← 完整生成的目录 +│ +├── 📁 skills/ ← 1,204+ 技能在这里 +│ │ +│ ├── 📁 brainstorming/ +│ │ └── 📄 SKILL.md ← 技能定义 +│ │ +│ ├── 📁 stripe-integration/ +│ │ ├── 📄 SKILL.md +│ │ └── 📁 examples/ ← 可选的额外内容 +│ │ +│ ├── 📁 game-development/ +│ │ └── 📁 2d-games/ +│ │ └── 📄 SKILL.md ← 也支持嵌套技能 +│ │ +│ └── ... (1,200+ 总计) +│ +├── 📁 apps/ +│ └── 📁 web-app/ ← 交互式浏览器 +│ +├── 📁 tools/ +│ ├── 📁 scripts/ ← 验证器和生成器 +│ ├── 📁 lib/ ← 共享辅助工具 +│ └── 📁 bin/ ← 安装程序入口点 +│ +└── 📁 docs/ + ├── 📁 users/ ← 入门指南、包、工作流程 + ├── 📁 contributors/ ← 模板、解剖、质量标准 + ├── 📁 maintainers/ ← 发布和维护文档 + └── 📁 sources/ ← 归属和许可证 +``` + +--- + +## 技能如何工作（流程图） + +``` +┌──────────────┐ +│ 1. 安装 │ 将技能复制到 .agent/skills/ +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 2. 调用 │ 在 AI 聊天中输入：@skill-name +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 3. 加载 │ AI 读取 SKILL.md 文件 +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 4. 执行 │ AI 遵循技能指令 +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 5. 结果 │ 您获得专业帮助！ +└──────────────┘ +``` + +--- + +## 🎯 技能类别（可视化地图） + +``` + ┌─────────────────────────┐ + │ 1,204+ 技能 │ + └────────────┬────────────┘ + │ + ┌────────────────────────┼────────────────────────┐ + │ │ │ + ┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐ + │ 产品 │ │ 开发 │ │ 安全 │ + │ & 用户体验│ │ & 测试 │ │ & 可靠性 │ + └────┬────┘ └──────┬──────┘ └──────┬──────┘ + │ │ │ + • 头脑风暴 • React / Next.js • 应用安全审查 + • 设计系统 • TDD / 调试 • 渗透测试指南 + • 文案撰写 • API / 后端 • 云加固 + • 事件响应 + │ │ │ + └────────────────────────┼────────────────────────┘ + │ + ┌────────────────────────┼────────────────────────┐ + │ │ │ + ┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐ + │ AI │ │ 数据/运维 │ │ 文档/开源 │ + │ 代理 │ │ & 云 │ │ 维护 │ + └────┬────┘ └──────┬──────┘ └──────┬──────┘ + │ │ │ + • RAG 系统 • SQL / 分析 • 发布流程 + • LangGraph • Docker / K8s • 更新日志 + • 提示工程 • Terraform / AWS • PR / 审查 + • 工具 / MCP • 可观测性 • 技能编写 +``` + +--- + +## 技能文件解剖（可视化） + +``` +┌─────────────────────────────────────────────────────────┐ +│ SKILL.md │ +├─────────────────────────────────────────────────────────┤ +│ │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ FRONTMATTER（元数据） │ │ +│ │ ───────────────────────────────────────────── │ │ +│ │ --- │ │ +│ │ name: my-skill │ │ +│ │ description: "What this skill does" │ │ +│ │ --- │ │ +│ └───────────────────────────────────────────────┘ │ +│ │ +│ ┌───────────────────────────────────────────────┐ │ +│ │ 内容（指令） │ │ +│ │ ───────────────────────────────────────────── │ │ +│ │ │ │ +│ │ # 技能标题 │ │ +│ │ │ │ +│ │ ## 概述 │ │ +│ │ 这个技能的作用... │ │ +│ │ │ │ +│ │ ## 何时使用 │ │ +│ │ - 在...时使用 │ │ +│ │ │ │ +│ │ ## 指令 │ │ +│ │ 1. 第一步... │ │ +│ │ 2. 第二步... │ │ +│ │ │ │ +│ │ ## 示例 │ │ +│ │ ```javascript │ │ +│ │ // 示例代码 │ │ +│ │ ``` │ │ +│ │ │ │ +│ └───────────────────────────────────────────────┘ │ +│ │ +└─────────────────────────────────────────────────────────┘ +``` + +--- + +## 安装（可视化步骤） + +### 步骤 1：克隆仓库 +``` +┌─────────────────────────────────────────┐ +│ 终端 │ +├─────────────────────────────────────────┤ +│ $ git clone https://github.com/ │ +│ sickn33/antigravity-awesome-skills │ +│ .agent/skills │ +│ │ +│ ✓ 正在克隆到 '.agent/skills'... │ +│ ✓ 完成！ │ +└─────────────────────────────────────────┘ +``` + +### 步骤 2：验证安装 +``` +┌─────────────────────────────────────────┐ +│ 文件资源管理器 │ +├─────────────────────────────────────────┤ +│ 📁 .agent/ │ +│ └── 📁 skills/ │ +│ ├── 📁 brainstorming/ │ +│ ├── 📁 stripe-integration/ │ +│ ├── 📁 react-best-practices/ │ +│ └── ... (1,200+ 总计) │ +└─────────────────────────────────────────┘ +``` + +### 步骤 3：使用技能 +``` +┌─────────────────────────────────────────┐ +│ AI 助手聊天 │ +├─────────────────────────────────────────┤ +│ 您：@brainstorming 帮我设计 │ +│ 一个待办事项应用 │ +│ │ +│ AI：太好了！让我帮您思考 │ +│ 这个问题。首先，让我们 │ +│ 了解您的需求... │ +│ │ +│ 主要用例是什么？ │ +│ a) 个人任务管理 │ +│ b) 团队协作 │ +│ c) 项目规划 │ +└─────────────────────────────────────────┘ +``` + +--- + +## 示例：使用技能（分步骤） + +### 场景：您想为应用添加 Stripe 支付 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 步骤 1：确定需求 │ +├─────────────────────────────────────────────────────────────┤ +│ "我需要为我的应用添加支付处理" │ +└─────────────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────┐ +│ 步骤 2：找到正确的技能 │ +├─────────────────────────────────────────────────────────────┤ +│ 搜索："payment" 或 "stripe" │ +│ 找到：@stripe-integration │ +└─────────────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────┐ +│ 步骤 3：调用技能 │ +├─────────────────────────────────────────────────────────────┤ +│ 您：@stripe-integration 帮我添加订阅计费 │ +└─────────────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────┐ +│ 步骤 4：AI 加载技能知识 │ +├─────────────────────────────────────────────────────────────┤ +│ • Stripe API 模式 │ +│ • Webhook 处理 │ +│ • 订阅管理 │ +│ • 最佳实践 │ +└─────────────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────────────┐ +│ 步骤 5：获得专业帮助 │ +├─────────────────────────────────────────────────────────────┤ +│ AI 提供： │ +│ • 代码示例 │ +│ • 设置说明 │ +│ • 安全考虑 │ +│ • 测试策略 │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +## 查找技能（可视化指南） + +### 方法 1：按类别浏览 +``` +README.md → 滚动到"完整技能注册表" → 找到类别 → 选择技能 +``` + +### 方法 2：按关键字搜索 +``` +终端 → ls skills/ | grep "keyword" → 查看匹配的技能 +``` + +### 方法 3：使用索引 +``` +打开 skills_index.json → 搜索关键字 → 找到技能路径 +``` + +--- + +## 创建您的第一个技能（可视化工作流程） + +``` +┌──────────────┐ +│ 1. 想法 │ "我想分享我的 Docker 知识" +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 2. 创建 │ mkdir skills/docker-mastery +└──────┬───────┘ touch skills/docker-mastery/SKILL.md + │ + ↓ +┌──────────────┐ +│ 3. 编写 │ 添加 frontmatter + 内容 +└──────┬───────┘ (使用 docs/contributors/skill-template.md) + │ + ↓ +┌──────────────┐ +│ 4. 测试 │ 复制到 .agent/skills/ +└──────┬───────┘ 尝试：@docker-mastery + │ + ↓ +┌──────────────┐ +│ 5. 验证 │ npm run validate +└──────┬───────┘ + │ + ↓ +┌──────────────┐ +│ 6. 提交 │ git commit + push + Pull Request +└──────────────┘ +``` + +--- + +## 技能复杂度级别 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 技能复杂度 │ +├─────────────────────────────────────────────────────────────┤ +│ │ +│ 简单 标准 复杂 │ +│ ────── ──────── ─────── │ +│ │ +│ • 1 个文件 • 1 个文件 • 多个 │ +│ • 100-200 字 • 300-800 字 • 800-2000 │ +│ • 基本结构 • 完整结构 • 脚本 │ +│ • 无额外内容 • 示例 • 示例 │ +│ • 最佳实践 • 模板 │ +│ • 文档 │ +│ 示例： 示例： 示例： │ +│ git-pushing brainstorming loki-mode │ +│ │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +## 🎯 贡献影响（可视化） + +``` +您的贡献 + │ + ├─→ 改进文档 + │ │ + │ └─→ 帮助数千开发者理解 + │ + ├─→ 创建新技能 + │ │ + │ └─→ 为所有人启用新功能 + │ + ├─→ 修复错误/拼写错误 + │ │ + │ └─→ 防止未来用户困惑 + │ + └─→ 添加示例 + │ + └─→ 使初学者学习更容易 +``` + +--- + +## 学习路径（可视化路线图） + +``` +从这里开始 + │ + ↓ +┌─────────────────┐ +│ 阅读 │ +│ GETTING_STARTED │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 在 AI 助手中 │ +│ 尝试 2-3 个技能 │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 阅读 │ +│ SKILL_ANATOMY │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 研究现有 │ +│ 技能 │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 创建简单 │ +│ 技能 │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 阅读 │ +│ CONTRIBUTING │ +└────────┬────────┘ + │ + ↓ +┌─────────────────┐ +│ 提交 PR │ +└────────┬────────┘ + │ + ↓ + 贡献者！🎉 +``` + +--- + +## 💡 快速提示（可视化速查表） + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 快速参考 │ +├─────────────────────────────────────────────────────────────┤ +│ │ +│ 📥 安装 │ +│ git clone [repo] .agent/skills │ +│ │ +│ 🎯 使用 │ +│ @skill-name [您的请求] │ +│ │ +│ 🔍 查找 │ +│ ls skills/ | grep "keyword" │ +│ │ +│ ✅ 验证 │ +│ npm run validate │ +│ │ +│ 📝 创建 │ +│ 1. mkdir skills/my-skill │ +│ 2. 使用 frontmatter 创建 SKILL.md │ +│ 3. 添加内容 │ +│ 4. 测试和验证 │ +│ 5. 提交 PR │ +│ │ +│ 🆘 帮助 │ +│ • docs/users/getting-started.md │ +│ • CONTRIBUTING.md │ +│ • docs/contributors/skill-anatomy.md │ +│ • GitHub Issues - 提问 │ +│ │ +└─────────────────────────────────────────────────────────────┘ +``` + +--- + +## 成功故事（可视化时间线） + +``` +第 1 天：安装技能 + │ + └─→ "哇，@brainstorming 帮我设计了应用！" + +第 3 天：使用 5 个不同的技能 + │ + └─→ "这些技能为我节省了这么多时间！" + +第 1 周：创建第一个技能 + │ + └─→ "我以技能的形式分享了我的专业知识！" + +第 2 周：技能被合并 + │ + └─→ "我的技能正在帮助其他人！🎉" + +第 1 个月：定期贡献者 + │ + └─→ "我已经贡献了 5 个技能并改进了文档！" +``` + +--- + +## 下一步 + +1. ✅ **理解**可视化结构 +2. ✅ **安装**您的 AI 工具中的技能 +3. ✅ **尝试**不同类别的 2-3 个技能 +4. ✅ **阅读** CONTRIBUTING.md +5. ✅ **创建**您的第一个技能 +6. ✅ **分享**给社区 + +--- + +**可视化学习者？**本指南应该有帮助！仍有问题？查看： +- [getting-started.md](getting-started.md) - 基于文本的介绍 +- [skill-anatomy.md](../contributors/skill-anatomy.md) - 详细分解 +- [CONTRIBUTING.md](../../CONTRIBUTING.md) - 如何贡献 + +**准备好贡献了吗？**您可以做到！💪 diff --git a/docs_zh-CN/users/workflows.md b/docs_zh-CN/users/workflows.md new file mode 100644 index 00000000..7b0b4bae --- /dev/null +++ b/docs_zh-CN/users/workflows.md @@ -0,0 +1,488 @@ +# Antigravity 工作流 + +> 工作流手册，以更少的摩擦协调多个技能。 + +## 什么是工作流？ + +工作流是一个指导性的、逐步执行路径，将多个技能组合起来实现一个具体目标。 + +- **包**告诉您哪些技能与某个角色相关。 +- **工作流**告诉您如何按顺序使用这些技能来完成实际目标。 + +如果包是您的工具箱，工作流就是您的执行手册。 + +--- + +## 如何使用工作流 + +1. 安装一次仓库（`npx antigravity-awesome-skills`）。 +2. 选择符合您即时目标的工作流。 +3. 按顺序执行步骤，并在每个步骤中调用的列出的技能。 +4. 在每个步骤保留输出成果（计划、决策、测试、验证证据）。 + +当您需要更广泛的覆盖范围时，可以将工作流与[bundles.md](bundles.md)中的包结合使用。 + +--- + +## 工作流：发布SaaS MVP + +构建并发布一个最小化但面向生产的SaaS产品。 + +### 步骤1：产品架构设计 +**技能：** [`@brainstorming`](../../skills/brainstorming/) + +**任务：** "使用 @brainstorming 设计SaaS MVP架构，包括： +- 核心功能识别 +- 技术栈选择 +- 数据库设计 +- API端点规划 +- 安全考虑" + +**产出：** 架构设计文档和功能列表 + +--- + +### 步骤2：UI/UX设计 +**技能：** [`@frontend-design`](../../skills/frontend-design/) + +**任务：** "使用 @frontend-design 为核心功能设计用户界面，包括： +- 用户注册/登录流程 +- 主要功能页面布局 +- 响应式设计 +- 无障碍考虑" + +**产出：** UI设计规范和线框图 + +--- + +### 步骤3：安全架构 +**技能：** [`@security-audit`](../../skills/security-audit/) + +**任务：** "使用 @security-audit 为SaaS设计安全架构，包括： +- 身份验证和授权 +- 数据保护 +- API安全 +- 合规要求（GDPR等）" + +**产出：** 安全设计文档和威胁模型 + +--- + +### 步骤4：数据库设计 +**技能：** [`@schema-design`](../../skills/schema-design/) + +**任务：** "使用 @schema-design 设计数据库模式，包括： +- 用户和权限表 +- 核心业务数据表 +- 索引策略 +- 数据迁移计划" + +**产出：** 完整的数据库模式和迁移脚本 + +--- + +### 步骤5：API开发 +**技能：** [`@api-design`](../../skills/api-design/) + +**任务：** "使用 @api-design 开发RESTful API，包括： +- 认证端点 +- 核心功能CRUD操作 +- 错误处理 +- API文档生成" + +**产出：** 完整的API实现和OpenAPI文档 + +--- + +### 步骤6：前端开发 +**技能：** [`@react-patterns`](../../skills/react-patterns/) + +**任务：** "使用 @react-patterns 构建前端应用，包括： +- 组件架构 +- 状态管理 +- 路由设计 +- 性能优化" + +**产出：** 生产就绪的前端应用 + +--- + +### 步骤7：测试策略 +**技能：** [`@test-driven-development`](../../skills/test-driven-development/) + +**任务：** "使用 @test-driven-development 为SaaS实施测试，包括： +- 单元测试 +- 集成测试 +- 端到端测试 +- 性能测试" + +**产出：** 完整的测试套件和CI/CD配置 + +--- + +### 步骤8：部署配置 +**技能：** [`@docker-expert`](../../skills/docker-expert/) + +**任务：** "使用 @docker-expert 配置生产部署，包括： +- 容器化配置 +- Docker Compose编排 +- 环境变量管理 +- 健康检查" + +**产出：** 部署配置和基础设施即代码 + +--- + +### 步骤9：性能优化 +**技能：** [`@performance-analyzer`](../../skills/performance-analyzer/) + +**任务：** "使用 @performance-analyzer 优化SaaS性能，包括： +- 数据库查询优化 +- 前端资源优化 +- 缓存策略 +- 监控设置" + +**产出：** 性能优化报告和监控仪表板 + +--- + +### 步骤10：发布准备 +**技能：** [`@deployment-pipeline`](../../skills/deployment-pipeline/) + +**任务：** "使用 @deployment-pipeline 准备生产发布，包括： +- 发布流程设计 +- 回滚策略 +- 监控告警 +- 用户文档" + +**产出：** 生产就绪的发布计划 + +--- + +## 工作流：Web应用安全审计 + +对现有Web应用进行全面安全评估。 + +### 步骤1：初步侦察 +**技能：** [`@reconnaissance`](../../skills/reconnaissance/) + +**任务：** "使用 @reconnaissance 收集目标信息，包括： +- 技术栈识别 +- 子域名枚举 +- 端口扫描 +- 公开信息收集" + +**产出：** 目标信息收集报告 + +--- + +### 步骤2：漏洞扫描 +**技能：** [`@vulnerability-scanner`](../../skills/vulnerability-scanner/) + +**任务：** "使用 @vulnerability-scanner 进行自动扫描，包括： +- 依赖漏洞检查 +- 配置安全检查 +- 已知漏洞扫描 +- 错误配置检测" + +**产出：** 自动扫描结果报告 + +--- + +### 步骤3：手动渗透测试 +**技能：** [`@pen-testing`](../../skills/pen-testing/) + +**任务：** "使用 @pen-testing 进行手动测试，包括： +- SQL注入测试 +- XSS漏洞测试 +- CSRF测试 +- 认证绕过测试" + +**产出：** 手动渗透测试报告 + +--- + +### 步骤4：API安全测试 +**技能：** [`@api-security-testing`](../../skills/api-security-testing/) + +**任务：** "使用 @api-security-testing 测试API安全，包括： +- 认证授权测试 +- 输入验证测试 +- 速率限制测试 +- 敏感数据泄露测试" + +**产出：** API安全测试报告 + +--- + +### 步骤5：业务逻辑测试 +**技能：** [`@business-logic-testing`](../../skills/business-logic-testing/) + +**任务：** "使用 @business-logic-testing 测试业务逻辑，包括： +- 权限提升测试 +- 价格操纵测试 +- 工作流程绕过 +- 数据完整性测试" + +**产出：** 业务逻辑安全报告 + +--- + +### 步骤6：社会工程测试 +**技能：** [`@social-engineering-testing`](../../skills/social-engineering-testing/) + +**任务：** "使用 @social-engineering-testing 进行社会工程测试，包括： +- 钓鱼邮件测试 +- 员工安全意识测试 +- 物理安全测试（如适用） +- 安全培训效果评估" + +**产出：** 社会工程测试报告 + +--- + +### 步骤7：报告和建议 +**技能：** [`@security-reporting`](../../skills/security-reporting/) + +**任务：** "使用 @security-reporting 生成综合报告，包括： +- 风险等级评估 +- 漏洞详细说明 +- 修复建议 +- 安全加固指南" + +**产出：** 完整的安全审计报告 + +--- + +## 工作流：AI应用开发 + +开发一个完整的AI驱动应用。 + +### 步骤1：AI策略规划 +**技能：** [`@ai-strategy`](../../skills/ai-strategy/) + +**任务：** "使用 @ai-strategy 规划AI应用，包括： +- AI模型选择 +- 数据需求分析 +- 性能指标定义 +- 伦理考虑" + +**产出：** AI策略文档 + +--- + +### 步骤2：数据工程 +**技能：** [`@data-engineering`](../../skills/data-engineering/) + +**任务：** "使用 @data-engineering 准备数据，包括： +- 数据收集策略 +- 清洗和预处理 +- 数据管道构建 +- 数据质量管理" + +**产出：** 数据管道和预处理脚本 + +--- + +### 步骤3：模型开发 +**技能：** [`@model-development`](../../skills/model-development/) + +**任务：** "使用 @model-development 开发AI模型，包括： +- 模型架构设计 +- 训练流程实现 +- 模型评估 +- 超参数调优" + +**产出：** 训练好的模型和评估报告 + +--- + +### 步骤4：提示工程 +**技能：** [`@prompt-engineer`](../../skills/prompt-engineer/) + +**任务：** "使用 @prompt-engineer 优化AI交互，包括： +- 提示模板设计 +- 上下文管理 +- 输出格式控制 +- 错误处理" + +**产出：** 提示模板和对话管理系统 + +--- + +### 步骤5：RAG系统构建 +**技能：** [`@rag-engineer`](../../skills/rag-engineer/) + +**任务：** "使用 @rag-engineer 构建RAG系统，包括： +- 向量数据库设置 +- 检索策略设计 +- 生成增强 +- 评估指标" + +**产出：** 完整的RAG系统 + +--- + +### 步骤6：应用集成 +**技能：** [`@ai-integration`](../../skills/ai-integration/) + +**任务：** "使用 @ai-integration 集成AI到应用，包括： +- API端点设计 +- 错误处理机制 +- 缓存策略 +- 监控设置" + +**产出：** 生产就绪的AI应用 + +--- + +## 工作流：全栈项目重构 + +重构遗留的全栈应用。 + +### 步骤1：代码审计 +**技能：** [`@code-audit`](../../skills/code-audit/) + +**任务：** "使用 @code-audit 审计现有代码，包括： +- 代码质量评估 +- 性能瓶颈识别 +- 安全漏洞检查 +- 技术债务分析" + +**产出：** 代码审计报告 + +--- + +### 步骤2：重构规划 +**技能：** [`@refactoring-planning`](../../skills/refactoring-planning/) + +**任务：** "使用 @refactoring-planning 制定重构计划，包括： +- 优先级排序 +- 风险评估 +- 时间线规划 +- 资源分配" + +**产出：** 重构执行计划 + +--- + +### 步骤3：数据库重构 +**技能：** [`@database-refactoring`](../../skills/database-refactoring/) + +**任务：** "使用 @database-refactoring 重构数据库，包括： +- 模式优化 +- 索引重建 +- 查询优化 +- 迁移脚本" + +**产出：** 优化后的数据库和迁移脚本 + +--- + +### 步骤4：后端重构 +**技能：** [`@backend-refactoring`](../../skills/backend-refactoring/) + +**任务：** "使用 @backend-refactoring 重构后端，包括： +- 架构现代化 +- 代码清理 +- 性能优化 +- 测试补全" + +**产出：** 重构后的后端代码 + +--- + +### 步骤5：前端重构 +**技能：** [`@frontend-refactoring`](../../skills/frontend-refactoring/) + +**任务：** "使用 @frontend-refactoring 重构前端，包括： +- 组件重构 +- 状态管理优化 +- 性能提升 +- 用户体验改进" + +**产出：** 重构后的前端代码 + +--- + +### 步骤6：测试验证 +**技能：** [`@testing-verification`](../../skills/testing-verification/) + +**任务：** "使用 @testing-verification 验证重构，包括： +- 回归测试 +- 性能对比 +- 安全验证 +- 用户验收测试" + +**产出：** 验证测试报告 + +--- + +## 💡 工作流最佳实践 + +### 📋 使用原则 + +1. **按顺序执行：** 不要跳过步骤，每个步骤都依赖前一步的产出 +2. **保存成果：** 每个步骤的输出都是下一步的重要输入 +3. **迭代改进：** 根据实际情况调整工作流 +4. **团队协作：** 分配不同步骤给不同专业角色 + +### 🔄 自定义工作流 + +**创建自定义工作流：** +1. 明确目标和成果 +2. 选择合适的技能组合 +3. 设计步骤顺序 +4. 定义每个步骤的产出要求 +5. 测试和优化 + +### 🎯 工作流选择指南 + +| 项目类型 | 推荐工作流 | 关键技能 | +| :------- | :----------- | :------- | +| **新SaaS产品** | Ship a SaaS MVP | 架构、安全、部署 | +| **安全审计** | Web应用安全审计 | 渗透测试、漏洞扫描 | +| **AI项目** | AI应用开发 | 模型开发、RAG工程 | +| **代码重构** | 全栈项目重构 | 代码审计、重构策略 | +| **移动应用** | 移动应用开发 | React Native、移动安全 | + +--- + +## 🆘 获取帮助 + +### ❓ 常见问题 + +**Q: 可以跳过某些步骤吗？** +A: 不建议。每个步骤都为后续步骤提供必要基础。 + +**Q: 工作流需要多长时间？** +A: 根据项目复杂度，从几天到几个月不等。 + +**Q: 可以并行执行步骤吗？** +A: 部分步骤可以并行，但需确保依赖关系。 + +### 📚 更多资源 + +- 📋 [技能包](bundles.md) - 按角色选择技能 +- 📖 [使用指南](usage.md) - 详细使用说明 +- ❓ [常见问题](faq.md) - 答疑解惑 +- 🤝 [社区讨论](https://github.com/sickn33/antigravity-awesome-skills/discussions) - 经验分享 + +--- + +## 🎉 开始使用工作流 + +现在您有了完整的工作流指南： + +1. **选择工作流**符合您的项目需求 +2. **按步骤执行**每个阶段的任务 +3. **保存每个产出**用于后续步骤 +4. **团队协作**提高效率 + +**立即开始：** + +```bash +"根据我的项目需求，使用最合适的工作流开始工作！" +``` + +祝您项目成功！🚀 \ No newline at end of file