From 4f30d4f2db050b43807f67e5cb58cc95986d93e1 Mon Sep 17 00:00:00 2001 From: GuDaStudio Date: Fri, 19 Dec 2025 14:58:49 +0800 Subject: [PATCH] =?UTF-8?q?v0.1.6=EF=BC=9A=E6=9B=B4=E6=96=B0README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 68 ++++++++++++++++++++++++------------------------------- 1 file changed, 30 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index 5c38415..91baad2 100644 --- a/README.md +++ b/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 +
+展开查看已收录的 Skills | 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 | +
+ --- ## 二、快速开始 ### 0. 前置要求 ->[!WARNING]请确保 Python 版本在3.8以上 +>[!IMPORTANT] >本项目使用于Python运行脚本，并要求版本在3.8以上，开发测试python版本为3.10. -请确保已安装并配置以下工具： +
+请确保已安装并配置以下工具! - [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) +
### 1. 获取仓库 +
+克隆仓库到任意位置。 + ```bash -# 克隆到任意位置 git clone --recurse-submodules https://github.com/GuDaStudio/skills cd skills ``` +
+ + ### 2. 安装 Skills -提供安装脚本，支持灵活选择安装范围和目标位置。 +本项目**提供一键安装脚本**，支持灵活选择安装范围和目标位置。 -
+
Linux / macOS **查看可用 Skills：** @@ -89,7 +99,7 @@ cd skills
-
+
Windows (PowerShell) **查看可用 Skills：** @@ -143,19 +153,28 @@ cd skills ### 3. 验证安装 -启动 Claude Code 后，Skills 会自动加载。可通过以下方式验证： +
+启动 Claude Code 后，Skills 会自动加载。可通过以下方式验证： - 让claude列出所有skill：`list all available SKILLs please` - Claude 应能识别并调用 `collaborating-with-codex` 和 `collaborating-with-gemini` ![这是图片](./imgs/verify.png) +
+ + + + ### 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**
(Route B) | **Backend / Logic** | **Codex** | **English**
Focus on: Logic & Algorithms | **Unified Diff Patch**
(Prototype Only) | • **Capability:** Use for complex debugging & algorithmic implementation.
• **Security:** **NO** file system write access allowed. | | **Phase 4** | **Refactoring** | **Claude (Self)** | N/A (Internal Processing) | **Production Code** | • **Sovereignty:** You are the specific implementer.
• **Style:** Clean, efficient, no redundancy. Minimal comments. | | **Phase 5** | **Audit & QA** | **Codex** AND **Gemini**
(Dual-Model) | **Unified Diff** + **Target File**
(English) | **Review Comments**
(Potential Bugs/Edge Cases) | • **Mandatory:** Triggered immediately after code changes.
• **Action:** Synthesize feedback into a final fix. | + ```` ---