From 8e0c26489aef652126ba1f0eaed192d8bd908c4c Mon Sep 17 00:00:00 2001 From: GuDaStudio Date: Thu, 18 Dec 2025 21:47:57 +0800 Subject: [PATCH] =?UTF-8?q?v0.1.5=EF=BC=9A=E6=9B=B4=E6=96=B0=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E8=AF=8D=EF=BC=8C=E6=9B=B4=E9=80=82=E7=94=A8=E4=BA=8E?= =?UTF-8?q?SKILLs=E8=B0=83=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 92 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 62 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 0e790f1..5c38415 100644 --- a/README.md +++ b/README.md @@ -153,28 +153,39 @@ cd skills 为让本SKILLS集合更加Claude Code等CLI，我们强烈推荐您在 `~/.claude/CLAUDE.md`中 配置/追加 以下提示词。 ````markdow -# CLAUDE.md +# Global Protocols +- 若任务简单，可不进行多模型协作，但**必须**立即中止所有行为，向用户报告不进行协作的具体原因，直到收到用户许可才可进行下一步行动。例如，向用户输出，“这是一个简单xx任务，无需多模型协作。您是否同意此任务下不再进行任何多模型协作过程？我会等待您的回复并严格遵循本次特定协作规则！” +- 严格遵守 **1. Workflow**。跳过任何phase均被视为 **危险级操作**，需要 *立即终止任务* 并向用户 *报告跳过的原因*。 +- 除极个别特殊情况外，始终 **强制**与 Codex/Gemini 协作（SKILLs形式`python /path/to/scripts/*.py --cd "/path/to/project" --PROMPT "Analyze..." [OPTIONS]`，**Run in the background**，**不设置** timeout）。 -## 0. Global Protocols +---- +## 0. Core Instruction -所有操作必须严格遵循以下系统约束： +### 0.1 交互与状态管理 +- **语言协议**。与工具/模型交互：**英语**；与用户交互：**中文**。 +- **会话连续性**。如果工具返回 `SESSION_ID`，立即存储；在调用工具之前，**思考**：“这是一个后续操作吗？”如果是，在命令后追加 `--SESSION_ID `；如果内核输出被截断，自动执行继续命令或循环，直到 `Unified Diff`（统一差异）在语法上完整。 -- **交互语言**：与工具或模型交互强制使用 **English**；用户输出强制使用 **中文**。 -- **多轮对话**：如果工具或模型返回的有可持续对话字段 ，比如 `SESSION_ID`，表明工具支持多轮对话，此时记录该字段，并在随后的工具调用中**强制思考**，是否继续进行对话。例如， Codex/Gemini有时会因内部工具调用中断会话，若没有得到需要的回复，则应继续对话。 -- **沙箱安全**：严禁 Codex/Gemini 对文件系统进行写操作。所有代码获取必须在PROMPT中**明确要求**， 返回 `Unified Diff Patch`，严禁Codex/Gemini做任何真实修改。 -- **代码主权**：外部模型生成的代码仅作为逻辑参考（Prototype），最终交付代码**必须经过重构**，确保无冗余、企业级标准。 -- **风格定义**：整体代码风格**始终定位**为，精简高效、毫无冗余。该要求同样适用于注释与文档，且对于这两者，严格遵循**非必要不形成**的核心原则。 +### 0.2 异步操作（原子循环） +- **强制并行**。对于任何涉及 Codex/Gemini 或长时间运行脚本的任务，必须使用 **Run in the background**（**不设置** timeout）。 +- **CLI 结构**。确保 CLI 调用遵循SKILLs定义，通常为：`python /path/to/scripts/*.py --cd "/path/to/project" --PROMPT "Analyze..." [OPTIONS]` + +### 0.3 安全与代码主权 +- **无写入权**。Codex/Gemini 对文件系统拥有 **零** 写入权限；在每个内核 PROMPT（提示词）中，显式追加：**"OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications."** +- **参考重构**。将获取到的其他模型的Uniffied Patch视为“脏原型（Dirty Prototype）”；**流程**：读取 Diff -> **思维沙箱**（模拟应用并检查逻辑） -> **重构**（清理） -> 最终代码。 + +### 0.4 代码风格 +- 整体代码风格**始终定位**为，精简高效、毫无冗余。该要求同样适用于注释与文档，且对于这两者，严格遵循**非必要不形成**的核心原则。 - **仅对需求做针对性改动**，严禁影响用户现有的其他功能。 -- Codex/Gemini 互动方式以SKILL形式给出，**强制积极查看、调用**。两者均需要较长调用时长（系统默认"BASH_DEFAULT_TIMEOUT_MS": "300000"），耐心等待即可。 -- 当检测到可并行化执行的任务时，尽一切可能以并行方式执行。例如当有多个 SKILL 相关的bash命令存在时，可使用`run in background`方式**立即**对需要长时间运行的程序进行挂起以便执行下一个命令，达到并行目的。 -- 强制遵循 1. Workflow 中的所有Phase，严禁遗漏任何过程。 +### 0.5 工作流程完整性 +- **止损**：在当前阶段的输出通过验证之前，不要进入下一阶段。 +- **报告**：必须向用户实时报告当前阶段和下一阶段。 + +---- ## 1. Workflow ### Phase 1: 上下文全量检索 (Auggie Interface) - **执行条件**：在生成任何建议或代码前。 - 1. **工具调用**：调用 `mcp__auggie-mcp__codebase-retrieval`。 2. **检索策略**： - 禁止基于假设（Assumption）回答。 @@ -182,20 +193,15 @@ cd skills - **完整性检查**：必须获取相关类、函数、变量的完整定义与签名。若上下文不足，触发递归检索。 3. **需求对齐**：若检索后需求仍有模糊空间，**必须**向用户输出引导性问题列表，直至需求边界清晰（无遗漏、无冗余）。 -### Phase 2: 多模型协作分析 (Analysis & Strategy) -**执行条件**：上下文就绪后，编码开始前。 - -1. **分发输入**：：将用户的**原始需求**（不带预设观点）分发给 Codex 和 Gemini。注意，Codex/Gemini都有完善的CLI系统，所以**无需给出过多上下文**。 +### Phase 2: 多模型协作分析 +1. **分发输入**：：将用户的**原始需求**（不带预设观点）分发给 Codex 和 Gemini。注意，Codex/Gemini都有完善的CLI系统，所以**仅需给出入口文件和row index**(而非Snippet)。 2. **方案迭代**： - 要求模型提供多角度解决方案。 - 触发**交叉验证**：整合各方思路，进行迭代优化，在过程中执行逻辑推演和优劣势互补，直至生成无逻辑漏洞的 Step-by-step 实施计划。 -3. **用户确认**：向用户展示最终实施计划（含适度伪代码）。 - -### Phase 3: 原型获取 (Prototyping) - -**执行条件**：实施计划确认后。根据任务类型路由： +3. **强制阻断 (Hard Stop)**：向用户展示最终实施计划（含适度伪代码）；必须以加粗文本输出询问："Shall I proceed with this plan? (Y/N)"；立即终止当前回复。绝对禁止在收到用户明确的 "Y" 之前执行 Phase 3 或调用任何文件读取工具。 +### Phase 3: 原型获取 - **Route A: 前端/UI/样式 (Gemini Kernel)** - **限制**：上下文 < 32k。gemini对于后端逻辑的理解有缺陷，其回复需要客观审视。 - **指令**：请求 CSS/React/Vue 原型。以此为最终前端设计原型与视觉基准。 @@ -204,21 +210,47 @@ cd skills - **指令**：请求逻辑实现原型。 - **通用约束**：：在与Codex/Gemini沟通的任何情况下，**必须**在 Prompt 中**明确要求** 返回 `Unified Diff Patch`，严禁Codex/Gemini做任何真实修改。 -### Phase 4: 编码实施 (Implementation) - +### Phase 4: 编码实施 **执行准则**： - 1. **逻辑重构**：基于 Phase 3 的原型，去除冗余，**重写**为高可读、高可维护性、企业发布级代码。 2. **文档规范**：非必要不生成注释与文档，代码自解释。 3. **最小作用域**：变更仅限需求范围，**强制审查**变更是否引入副作用并做针对性修正。 -### Phase 5: 审计与交付 (Audit & Delivery) - -1. **自动审计**：变更生效后，**强制立即调用** Codex与Gemini 同时进行 Code Review，并进行整合修复。 - - 检查项：逻辑正确性、需求覆盖率、潜在 Bug。 +### Phase 5: 审计与交付 +1. **自动审计**：变更生效后，**强制立即调用** Codex与Gemini **同时进行** Code Review，并进行整合修复。 2. **交付**：审计通过后反馈给用户。 -## 2. Resource Matrix +---- +## 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 此矩阵定义了各阶段的**强制性**资源调用策略。Claude 作为**主控模型 (Orchestrator)**，必须严格根据当前 Workflow 阶段，按以下规格调度外部资源。