mirror of
https://github.com/GuDaStudio/skills.git
synced 2026-02-04 18:40:41 +08:00
v0.1.6：更新README
This commit is contained in:
GuDaStudio
68
README.md
68
README.md
@@ -18,41 +18,51 @@
|
||||
|
||||
**Agent Skills** 是 [Anthropic 推出的](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)模块化能力扩展机制，让 LLM 能够按需加载专业领域知识与工作流。本仓库收录了 **GudaStudio** 开发的 Agent Skills 集合，实现 Claude 与其他 AI 模型、工具的无缝协作。
|
||||
|
||||
### 已收录的 Skills
|
||||
<details>
|
||||
<summary><b>展开查看已收录的 Skills</b></summary>
|
||||
|
||||
| Skill | 功能描述 | 协作模型 |
|
||||
|-------|----------|----------|
|
||||
| [collaborating-with-codex](https://github.com/GuDaStudio/collaborating-with-codex) | 将编码任务委托给 Codex CLI，用于原型开发、调试和代码审查 | OpenAI Codex |
|
||||
| [collaborating-with-gemini](https://github.com/GuDaStudio/collaborating-with-gemini) | 将编码任务委托给 Gemini CLI，用于原型开发、调试和代码审查 | Google Gemini |
|
||||
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## 二、快速开始
|
||||
|
||||
### 0. 前置要求
|
||||
|
||||
>[!WARNING]请确保 Python 版本在3.8以上
|
||||
>[!IMPORTANT]
|
||||
>本项目使用于Python运行脚本，并要求版本在3.8以上，开发测试python版本为3.10.
|
||||
|
||||
请确保已安装并配置以下工具：
|
||||
<details>
|
||||
<summary><b>请确保已安装并配置以下工具!</b></summary>
|
||||
|
||||
- [Claude Code](https://docs.claude.com/docs/claude-code) (v2.0.56+)
|
||||
- [Codex CLI](https://github.com/openai/codex) (若使用 collaborating-with-codex)
|
||||
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) (若使用 collaborating-with-gemini)
|
||||
</details>
|
||||
|
||||
### 1. 获取仓库
|
||||
|
||||
<details>
|
||||
<summary><b>克隆仓库到任意位置。</b></summary>
|
||||
|
||||
```bash
|
||||
# 克隆到任意位置
|
||||
git clone --recurse-submodules https://github.com/GuDaStudio/skills
|
||||
cd skills
|
||||
```
|
||||
</details>
|
||||
|
||||
|
||||
|
||||
### 2. 安装 Skills
|
||||
|
||||
提供安装脚本，支持灵活选择安装范围和目标位置。
|
||||
本项目**提供一键安装脚本**，支持灵活选择安装范围和目标位置。
|
||||
|
||||
<details open>
|
||||
<details>
|
||||
<summary><b>Linux / macOS</b></summary>
|
||||
|
||||
**查看可用 Skills：**
|
||||
@@ -89,7 +99,7 @@ cd skills
|
||||
|
||||
</details>
|
||||
|
||||
<details open>
|
||||
<details>
|
||||
<summary><b>Windows (PowerShell)</b></summary>
|
||||
|
||||
**查看可用 Skills：**
|
||||
@@ -143,19 +153,28 @@ cd skills
|
||||
|
||||
### 3. 验证安装
|
||||
|
||||
启动 Claude Code 后，Skills 会自动加载。可通过以下方式验证：
|
||||
<details>
|
||||
<summary><b>启动 Claude Code 后，Skills 会自动加载。可通过以下方式验证：</b></summary>
|
||||
|
||||
- 让claude列出所有skill：`list all available SKILLs please`
|
||||
- Claude 应能识别并调用 `collaborating-with-codex` 和 `collaborating-with-gemini`
|
||||
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
|
||||
|
||||
### 4. （🎊可选，但强烈推荐）配置提示词
|
||||
为让本SKILLS集合更加Claude Code等CLI，我们强烈推荐您在 `~/.claude/CLAUDE.md`中 配置/追加 以下提示词。
|
||||
|
||||
>[!IMPORTANT]
|
||||
>本全局提示词使用了auggie-mcp,可参考[官方安装教程](https://docs.augmentcode.com/context-services/mcp/quickstart-claude-code).
|
||||
|
||||
````markdow
|
||||
# Global Protocols
|
||||
- 若任务简单，可不进行多模型协作，但**必须**立即中止所有行为，向用户报告不进行协作的具体原因，直到收到用户许可才可进行下一步行动。例如，向用户输出，“这是一个简单xx任务，无需多模型协作。您是否同意此任务下不再进行任何多模型协作过程？我会等待您的回复并严格遵循本次特定协作规则！”
|
||||
- 严格遵守 **1. Workflow**。跳过任何phase均被视为 **危险级操作**，需要 *立即终止任务* 并向用户 *报告跳过的原因*。
|
||||
- 严格遵守 **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）。
|
||||
|
||||
----
|
||||
@@ -221,36 +240,8 @@ cd skills
|
||||
2. **交付**：审计通过后反馈给用户。
|
||||
|
||||
----
|
||||
## 2. Git 提交标准
|
||||
必须严格遵守以下规则生成提交信息。
|
||||
|
||||
### 2.1 预计算
|
||||
1. **历史检查**：执行 `git log -n 5` 分析现有的提交风格。
|
||||
2. **版本检测**：检查项目配置（如 `package.json`、`pom.xml` 或最新的 git tag）以确定 *当前* 版本。*关键*：不要猜测版本。如果无法检测，省略版本前缀。*逻辑*：功能/重构 (Feature/Refactor) -> 升级次版本号 (v0.1.0 -> v0.2.0)；修复/补丁 (Bugfix/Patch) -> 升级修订号 (v0.1.0 -> v0.1.1)
|
||||
|
||||
### 2.2 格式规则
|
||||
- **语言**：**中文（简体）**。
|
||||
- **结构**：`[版本号]：[摘要]。[详情，以分号分隔];`
|
||||
- **风格**：
|
||||
- **单段落**：信息正文中严禁换行。
|
||||
- **简洁**：使用专业技术术语。
|
||||
- **无尾注**：严禁出现 `Co-Authored-By`、`Generated by` 或任何 AI 免责声明。提交信息必须看起来 100% 像人类写的。
|
||||
|
||||
### 2.3 示例
|
||||
|
||||
**错误示例（切勿使用）**：
|
||||
```text
|
||||
v0.7.1：Update icons
|
||||
- Added thumbnail field
|
||||
- Fixed display logic
|
||||
🤖 Generated by Claude
|
||||
```
|
||||
**正确示例（严格遵守）**：
|
||||
```text
|
||||
v0.7.1：会话历史使用AI生成图片的缩略图作为图标。在ConversationSummary中添加thumbnail字段存储缩略图；persistCurrentConversation时提取最后一张AI生成图片生成64px缩略图；会话列表中有缩略图时显示36px图片，无缩略图时显示原对话图标。
|
||||
```
|
||||
|
||||
## 3. Resource Matrix
|
||||
## 2. Resource Matrix
|
||||
|
||||
此矩阵定义了各阶段的**强制性**资源调用策略。Claude 作为**主控模型 (Orchestrator)**，必须严格根据当前 Workflow 阶段，按以下规格调度外部资源。
|
||||
|
||||
@@ -262,6 +253,7 @@ v0.7.1：会话历史使用AI生成图片的缩略图作为图标。在Conversat
|
||||
| **Phase 3**<br>(Route B) | **Backend / Logic** | **Codex** | **English**<br>Focus on: Logic & Algorithms | **Unified Diff Patch**<br>(Prototype Only) | • **Capability:** Use for complex debugging & algorithmic implementation.<br>• **Security:** **NO** file system write access allowed. |
|
||||
| **Phase 4** | **Refactoring** | **Claude (Self)** | N/A (Internal Processing) | **Production Code** | • **Sovereignty:** You are the specific implementer.<br>• **Style:** Clean, efficient, no redundancy. Minimal comments. |
|
||||
| **Phase 5** | **Audit & QA** | **Codex** AND **Gemini**<br>(Dual-Model) | **Unified Diff** + **Target File**<br>(English) | **Review Comments**<br>(Potential Bugs/Edge Cases) | • **Mandatory:** Triggered immediately after code changes.<br>• **Action:** Synthesize feedback into a final fix. |
|
||||
|
||||
````
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user