firefrost-gaming/antigravity-skills-reference

Files

dz3ai a1ef780467 add Chinese docs (#232 )

* add Chinese docs

* docs: Add missing Chinese translations and update README.zh-CN.md links

- Add 4 new Chinese translation files:
  - contributors/examples.md: Real-world examples of using skills
  - maintainers/audit.md: Repository coherence and correctness audit guide
  - maintainers/ci-drift-fix.md: CI drift fix guide
  - users/visual-guide.md: Visual quick start guide with diagrams

- Update README.zh-CN.md to replace docs/ links with docs_zh-CN/ links for:
  - Navigation section
  - Documentation table
  - Contributing section

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-08 08:35:17 +01:00

5.9 KiB

Raw Blame History

name, description, category, risk, source, date_added, author, tags, tools

name

description

技能标题

概述

简要说明这个技能的作用以及它为什么存在。 2-4句话最合适。

何时使用此技能

当您需要[场景1]时使用
在处理[场景2]时使用
当用户询问[场景3]时使用

工作原理

步骤1：[操作]

详细说明...

步骤2：[操作]

更多说明...

示例

示例1：[用例]

// 示例代码或说明

示例2：[用例]

# Python示例代码

最佳实践

实践建议1
实践建议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等）

示例：

---
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

📝 内容结构指南

必需章节：

概述（Overview）
- 2-4句话说明技能作用
- 解释为什么需要这个技能
何时使用（When to Use This Skill）
- 具体的使用场景
- 使用条件说明
工作原理（How It Works）
- 逐步操作说明
- 清晰的执行流程

可选章节：

示例（Examples）
- 具体使用示例
- 代码片段或配置
最佳实践（Best Practices）
- 推荐的用法
- 避免的陷阱
相关技能（Related Skills）
- 相关的其他技能
- 技能组合建议
常见问题（FAQ）
- 常见问题和解答
- 故障排除指南
限制和注意事项（Limitations）
- 技能的限制
- 使用注意事项

✅ 质量检查清单

内容质量：

描述清晰准确
示例可运行
文档完整
语言简洁明了

格式规范：

前置内容完整
分类正确
标签合适
工具支持明确

技术质量：

指导可执行
最佳实践遵循
安全考虑周全
错误处理合理

🚀 提交指南

文件命名：

使用小写字母和连字符
不要包含特殊字符
目录名与技能名称一致
文件名为：SKILL.md

目录结构：

skills/
├── skill-name/
│   ├── SKILL.md
│   ├── examples/
│   │   ├── example1.md
│   │   └── example2.md
│   └── scripts/
│       └── helper-script.py

提交流程：

Fork仓库
创建技能目录
编写SKILL.md文件
添加示例和脚本（可选）
运行验证：npm run validate
提交Pull Request

📞 获取帮助

资源链接：

联系方式：

📧 skills@antigravity-skills.org
💬 Discord: #技能贡献频道

🎉 开始贡献

感谢您考虑为Antigravity Awesome Skills贡献！使用这个模板，您可以帮助创建高质量、一致性的技能，让整个社区受益。

如果您有任何疑问或需要指导，请随时联系我们。

期待您的贡献！ 🚀

5.9 KiB Raw Blame History Unescape Escape