G
GuDaStudio/skills
This repository contains a collection of Agent Skills developed by GudaStudio, enabling seamless collaboration between Claude and other AI models and tools.
PowerShellMIT创建于 2025/12/16更新于 今天
README
由 Gemini 翻译整理
Agent Skills 集合 —— 让 Claude 与多模型/工具无缝协作
⭐ 在 GitHub 上给我们点星~您的支持对我们意义重大！ 🙏😊
English | 简体中文
一、项目简介
Agent Skills 是 Anthropic 推出的模块化能力扩展机制，让 LLM 能够按需加载专业领域知识与工作流。本仓库收录了 GudaStudio 开发的 Agent Skills 集合，实现 Claude 与其他 AI 模型、工具的无缝协作。
展开查看已收录的 Skills
| Skill | 功能描述 | 协作模型 |
|---|---|---|
| collaborating-with-codex | 将编码任务委托给 Codex CLI，用于原型开发、调试和代码审查 | OpenAI Codex |
| collaborating-with-gemini | 将编码任务委托给 Gemini CLI，用于原型开发、调试和代码审查 | Google Gemini |
二、快速开始
0. 前置要求
[!IMPORTANT] 本项目使用 Python 运行脚本，要求版本在 3.8 以上，开发测试所使用的 Python 版本为 3.10。
请确保已安装并配置以下工具：
- Claude Code (v2.0.56+)
- Codex CLI (若使用 collaborating-with-codex)
- Gemini CLI (若使用 collaborating-with-gemini)
1. 获取仓库
克隆仓库到任意位置。
git clone --recurse-submodules https://github.com/GuDaStudio/skills
cd skills
2. 安装 Skills
本项目提供一键安装脚本，支持灵活选择安装范围和目标位置。
Linux / macOS
查看可用 Skills：
./install.sh --list
方式一：一键安装所有 Skills
# 用户级安装（所有项目生效）
./install.sh --user --all
# 项目级安装（仅当前项目生效，需在项目根目录执行）
./install.sh --project --all
方式二：选择性安装
# 仅安装 collaborating-with-codex
./install.sh --user --skill collaborating-with-codex
# 安装多个指定 Skill
./install.sh --user -s collaborating-with-codex -s collaborating-with-gemini
方式三：自定义安装路径
./install.sh --target /your/custom/path --all
Windows (PowerShell)
查看可用 Skills：
.\install.ps1 -List
方式一：一键安装所有 Skills
# 用户级安装（所有项目生效）
.\install.ps1 -User -All
# 项目级安装（仅当前项目生效，需在项目根目录执行）
.\install.ps1 -Project -All
方式二：选择性安装
# 仅安装 collaborating-with-codex
.\install.ps1 -User -Skill collaborating-with-codex
# 安装多个指定 Skill
.\install.ps1 -User -Skill collaborating-with-codex -Skill collaborating-with-gemini
方式三：自定义安装路径
.\install.ps1 -Target C:\your\custom\path -All
点击查看完整参数说明
| 参数 (Bash) | 参数 (PowerShell) | 简写 | 说明 |
|---|---|---|---|
--user | -User | -u | 安装到用户级目录 (~/.claude/skills/) |
--project | -Project | -p | 安装到项目级目录 (./.claude/skills/) |
--target | -Target | -t | 安装到自定义路径 |
--all | -All | -a | 安装所有可用 Skills |
--skill | -Skill | -s | 安装指定 Skill（可多次使用） |
--list | -List | -l | 列出所有可用 Skills |
--help | -Help | -h | 显示帮助信息 |
3. 验证安装
启动 Claude Code 后，Skills 会自动加载。可通过以下方式验证：
- 让 Claude 列出所有 skill：
list all available SKILLs please - Claude 应能识别并调用
collaborating-with-codex和collaborating-with-gemini
4. （🎊可选，但强烈推荐）配置提示词
为让本 SKILLS 集合更适配 Claude Code 等 CLI，我们强烈推荐您在 ~/.claude/CLAUDE.md 中配置/追加以下提示词。
[!IMPORTANT] 本全局提示词使用了 auggie-mcp，可参考官方安装教程。
# Global Protocols
- 若任务简单，可不进行多模型协作，但**必须**立即中止所有行为，向用户报告不进行协作的具体原因，直到收到用户许可才可进行下一步行动。例如，向用户输出，“这是一个简单xx任务，无需多模型协作。您是否同意此任务下不再进行任何多模型协作过程？我会等待您的回复并严格遵循本次特定协作规则！”
- 严格遵守 **1. Workflow**。跳过任何phase均被视为 **危险级操作**，需要 *立即终止任务* 并向用户 *报告跳过的原因*。例如，向用户输出，“在当前的xx phase，我发现xx，所以下一xx phase的任务实质上已经被xx解决。您是否同意我跳过xx phase？我会等待，直到收到您确定的回复再继续下一phase行动！”
- 除极个别特殊情况外，始终 **强制**与 Codex/Gemini 协作（SKILLs形式`python /path/to/scripts/*.py --cd "/path/to/project" --PROMPT "Analyze..." [OPTIONS]`，**Run in the background**，**不设置** timeout）。
----
## 0. Core Instruction
### 0.1 交互与状态管理
- **语言协议**。与工具/模型交互：**英语**；与用户交互：**中文**。
- **会话连续性**。如果工具返回 `SESSION_ID`，立即存储；在调用工具之前，**思考**：“这是一个后续操作吗？”如果是，在命令后追加 `--SESSION_ID `；如果内核输出被截断，自动执行继续命令或循环，直到 `Unified Diff`（统一差异）在语法上完整。
### 0.2 异步操作（原子循环）
- **强制并行**。对于任何涉及 Codex/Gemini 或长时间运行脚本的任务，必须使用 **Run in the background**（**