mirror of
https://github.com/GuDaStudio/skills.git
synced 2026-02-05 02:50:26 +08:00
v0.1.6:更新README
This commit is contained in:
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 模型、工具的无缝协作。
|
**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 | 功能描述 | 协作模型 |
|
| Skill | 功能描述 | 协作模型 |
|
||||||
|-------|----------|----------|
|
|-------|----------|----------|
|
||||||
| [collaborating-with-codex](https://github.com/GuDaStudio/collaborating-with-codex) | 将编码任务委托给 Codex CLI,用于原型开发、调试和代码审查 | OpenAI Codex |
|
| [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 |
|
| [collaborating-with-gemini](https://github.com/GuDaStudio/collaborating-with-gemini) | 将编码任务委托给 Gemini CLI,用于原型开发、调试和代码审查 | Google Gemini |
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 二、快速开始
|
## 二、快速开始
|
||||||
|
|
||||||
### 0. 前置要求
|
### 0. 前置要求
|
||||||
|
|
||||||
>[!WARNING]请确保 Python 版本在3.8以上
|
>[!IMPORTANT]
|
||||||
>本项目使用于Python运行脚本,并要求版本在3.8以上,开发测试python版本为3.10.
|
>本项目使用于Python运行脚本,并要求版本在3.8以上,开发测试python版本为3.10.
|
||||||
|
|
||||||
请确保已安装并配置以下工具:
|
<details>
|
||||||
|
<summary><b>请确保已安装并配置以下工具!</b></summary>
|
||||||
|
|
||||||
- [Claude Code](https://docs.claude.com/docs/claude-code) (v2.0.56+)
|
- [Claude Code](https://docs.claude.com/docs/claude-code) (v2.0.56+)
|
||||||
- [Codex CLI](https://github.com/openai/codex) (若使用 collaborating-with-codex)
|
- [Codex CLI](https://github.com/openai/codex) (若使用 collaborating-with-codex)
|
||||||
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) (若使用 collaborating-with-gemini)
|
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) (若使用 collaborating-with-gemini)
|
||||||
|
</details>
|
||||||
|
|
||||||
### 1. 获取仓库
|
### 1. 获取仓库
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>克隆仓库到任意位置。</b></summary>
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 克隆到任意位置
|
|
||||||
git clone --recurse-submodules https://github.com/GuDaStudio/skills
|
git clone --recurse-submodules https://github.com/GuDaStudio/skills
|
||||||
cd skills
|
cd skills
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 2. 安装 Skills
|
### 2. 安装 Skills
|
||||||
|
|
||||||
提供安装脚本,支持灵活选择安装范围和目标位置。
|
本项目**提供一键安装脚本**,支持灵活选择安装范围和目标位置。
|
||||||
|
|
||||||
<details open>
|
<details>
|
||||||
<summary><b>Linux / macOS</b></summary>
|
<summary><b>Linux / macOS</b></summary>
|
||||||
|
|
||||||
**查看可用 Skills:**
|
**查看可用 Skills:**
|
||||||
@@ -89,7 +99,7 @@ cd skills
|
|||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
<details open>
|
<details>
|
||||||
<summary><b>Windows (PowerShell)</b></summary>
|
<summary><b>Windows (PowerShell)</b></summary>
|
||||||
|
|
||||||
**查看可用 Skills:**
|
**查看可用 Skills:**
|
||||||
@@ -143,19 +153,28 @@ cd skills
|
|||||||
|
|
||||||
### 3. 验证安装
|
### 3. 验证安装
|
||||||
|
|
||||||
启动 Claude Code 后,Skills 会自动加载。可通过以下方式验证:
|
<details>
|
||||||
|
<summary><b>启动 Claude Code 后,Skills 会自动加载。可通过以下方式验证:</b></summary>
|
||||||
|
|
||||||
- 让claude列出所有skill:`list all available SKILLs please`
|
- 让claude列出所有skill:`list all available SKILLs please`
|
||||||
- Claude 应能识别并调用 `collaborating-with-codex` 和 `collaborating-with-gemini`
|
- Claude 应能识别并调用 `collaborating-with-codex` 和 `collaborating-with-gemini`
|
||||||

|

|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 4. (🎊可选,但强烈推荐)配置提示词
|
### 4. (🎊可选,但强烈推荐)配置提示词
|
||||||
为让本SKILLS集合更加Claude Code等CLI,我们强烈推荐您在 `~/.claude/CLAUDE.md`中 配置/追加 以下提示词。
|
为让本SKILLS集合更加Claude Code等CLI,我们强烈推荐您在 `~/.claude/CLAUDE.md`中 配置/追加 以下提示词。
|
||||||
|
|
||||||
|
>[!IMPORTANT]
|
||||||
|
>本全局提示词使用了auggie-mcp,可参考[官方安装教程](https://docs.augmentcode.com/context-services/mcp/quickstart-claude-code).
|
||||||
|
|
||||||
````markdow
|
````markdow
|
||||||
# Global Protocols
|
# Global Protocols
|
||||||
- 若任务简单,可不进行多模型协作,但**必须**立即中止所有行为,向用户报告不进行协作的具体原因,直到收到用户许可才可进行下一步行动。例如,向用户输出,“这是一个简单xx任务,无需多模型协作。您是否同意此任务下不再进行任何多模型协作过程?我会等待您的回复并严格遵循本次特定协作规则!”
|
- 若任务简单,可不进行多模型协作,但**必须**立即中止所有行为,向用户报告不进行协作的具体原因,直到收到用户许可才可进行下一步行动。例如,向用户输出,“这是一个简单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)。
|
- 除极个别特殊情况外,始终 **强制**与 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. **交付**:审计通过后反馈给用户。
|
||||||
|
|
||||||
----
|
----
|
||||||
## 2. Git 提交标准
|
|
||||||
必须严格遵守以下规则生成提交信息。
|
|
||||||
|
|
||||||
### 2.1 预计算
|
## 2. Resource Matrix
|
||||||
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
|
|
||||||
|
|
||||||
此矩阵定义了各阶段的**强制性**资源调用策略。Claude 作为**主控模型 (Orchestrator)**,必须严格根据当前 Workflow 阶段,按以下规格调度外部资源。
|
此矩阵定义了各阶段的**强制性**资源调用策略。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 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 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. |
|
| **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