ViewWay/hermes-by-everythings

آخر نشاط مصدر مسجل: ١٩ يونيو ٢٠٢٦ في ١٤:١٥

آخر تحديث لفهرس SkillsMP: ٩ نوفمبر ٢٠٢٦ في ١٤:٢٢

skills مجمعة: ٣

نجوم GitHub: ٣
تفرعات GitHub: ٠

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/ViewWay/hermes-by-everythings.

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# Hermes-by-Everything <p align="center"> <img src="assets/logo.svg" alt="Hermes-by-Everything — 多平台多语言编码增强套件" width="320"> </p> [![Stars](https://img.shields.io/github/stars/ViewWay/hermes-by-everythings?style=flat)](https://github.com/ViewWay/hermes-by-everythings/stargazers) [![Forks](https://img.shields.io/github/forks/ViewWay/hermes-by-everythings?style=flat)](https://github.com/ViewWay/hermes-by-everythings/network/members) [![Contributors](https://img.shields.io/github/contributors/ViewWay/hermes-by-everythings?style=flat)](https://github.com/ViewWay/hermes-by-everythings/graphs/contributors) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Version](https://img.shields.io/badge/version-3.3.1-green.svg)](https://github.com/ViewWay/hermes-by-everythings/releases) ![Shell](https://img.shields.io/badge/-Shell-4EAA25?logo=gnu-bash&logoColor=white) ![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white) ![Python](https://img.shields.io/badge/-Python-3776AB?logo=python&logoColor=white) ![Rust](https://img.shields.io/badge/-Rust-000000?logo=rust&logoColor=white) ![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white) ![Java](https://img.shields.io/badge/-Java-ED8B00?logo=openjdk&logoColor=white) ![Kotlin](https://img.shields.io/badge/-Kotlin-7F52FF?logo=kotlin&logoColor=white) ![C#](https://img.shields.io/badge/-C%23-512BD4?logo=c-sharp&logoColor=white) ![Ruby](https://img.shields.io/badge/-Ruby-CC342D?logo=ruby&logoColor=white) ![PHP](https://img.shields.io/badge/-PHP-777BB4?logo=php&logoColor=white) ![Swift](https://img.shields.io/badge/-Swift-F05138?logo=swift&logoColor=white) > **37 专业代理** | **33 核心技能** | **22 快捷命令** | **77 规则文件** | **Ralph 自主循环** | **Orchestrator 编排** --- <div align="center"> **Language / 语言** [**English**](README.md) | [简体中文](README.zh-CN.md) </div> --- **多平台多语言编码增强套件 - 整合 everything-claude-code 和 ralph 的最佳能力** Hermes-by-Everything (HBE) 是一个生产级的编码增强系统，整合了 [everything-claude-code](https://github.com/affaan-m/everything-claude-code) 的全面能力和 [Ralph 模式](https://github.com/frankbria/ralph-claude-code)的会话内自主循环工作流。它提供 39 个专业代理、33 个核心技能、18 个快捷命令、83 个规则文件，以及基于 Ralph 模式的自主循环工作流（通过 `/hbe-ralph` 命令在会话内执行 TDD 循环，规避上下文窗口限制）。支持 **10 种主流编程语言**（TypeScript/JavaScript、Python、Rust、Go、Java、Kotlin、C#、Ruby、PHP、Swift），可通过 **插件市场** 安装到 **Claude Code、ZCode、Codex** 三大平台（也兼容 Hermes、OpenCode、OpenClaw），运行在 **3 种操作系统**（macOS、Windows、Linux）上。 **核心特性**：百分百触发机制、闭环学习系统、无人值守推进、自我更新学习、纯净上下文管理。 --- ## 核心特性 ### 🤖 专业代理（39 个） | 代理 | 命令 | 说明 | 专长 | |------|------|------|------| | **orchestrator** | `/hbe-orchestrate` | 多Agent编排 | 任务分解、批量开发、质量闭环、Agent resume | | **planner** | `/hbe-plan` | 实现规划 | 需求分析、任务拆解、风险评估 | | **architect** | `/hbe-architect` | 架构设计 | 系统设计、组件职责、数据模型 | | **code-reviewer** | `/hbe-review` | 代码审查 | 质量检查、性能优化、安全审查 | | **security-reviewer** | `/hbe-security` | 安全审查 | OWASP Top 10、漏洞扫描、合规检查 | | **tdd-guide** | `/hbe-tdd` | TDD 开发 | 红-绿-重构、测试驱动、覆盖率保证 | | **build-error-resolver** | `/hbe-build-fix` | 构建修复 | 错误诊断、最小修复、验证回归 | | **e2e-runner** | `/hbe-e2e` | E2E 测试 | 端到端测试、Playwright、用户流程 | | **refactor-cleaner** | `/hbe-refactor` | 重构清理 | 死代码检测、安全移除、依赖清理 | | **doc-updater** | `/hbe-docs` | 文档更新 | Codemap 生成、文档同步、依赖图 | ### 🛠️ 核心技能（13 个） | 技能 | 说明 | 使用场景 | |------|------|----------| | **prd** | PRD 需求文档生成 | 需求分析、功能规划 | | **ralph** | PRD 转 prd.json + 自主执行循环 | 大型任务自动化 | | **tdd-workflow** | TDD 红-绿-重构工作流 | 测试驱动开发 | | **coding-standards** | 编码标准 | 代码风格、最佳实践 | | **backend-patterns** | 后端模式 | 服务端架构、API 设计 | | **frontend-patterns** | 前端模式 | 组件设计、状态管理 | | **security-review** | 安全审查清单 | 漏洞检测、安全加固 | | **continuous-learning** | 会话模式提取自动生成 skill | 自我学习、知识积累 | | **strategic-compact** | 上下文战略压缩提示 | Token 优化、上下文管理 | | **verification-loop** | 五阶段验证循环 | 构建检查、类型检查、Lint、测试、安全 | | **eval-harness** | 评估驱动开发 | pass@k 指标、能力评估 | | **project-guidelines** | 项目特定规范 | 团队约定、项目规范 | | **orchestration** | 多 Agent 编排 | 复杂工作流、端到端自动化 | ### ⚡ 快捷命令（22 个） ```bash # 规划与开发 /hbe-plan # 实现规划 /hbe-architect # 架构设计 /hbe-tdd # TDD 开发流程 /hbe-review # 代码审查 /hbe-security # 安全审查 hbe-scan # 统一安全扫描 (SAST/SCA/密钥/复杂度) /hbe-build-fix # 构建修复 /hbe-e2e # E2E 测试生成 /hbe-refactor # 重构清理 /hbe-docs # 文档/Codemap 更新 # Git 工作流 /hbe-commit # 生成 Conventional Commit 提交消息 /hbe-pr-create # 创建 Pull Request + 自动生成描述 /hbe-pr-review # 审查 Pull Request /hbe-branch # 分支管理 + 清理 # 编排与自动化 /hbe-prd # PRD 生成 /hbe-verify # 五阶段验证 /hbe-orchestrate # 多 Agent 流水线 /hbe-ralph # 自主执行循环 /hbe-checkpoint # 保存进度快照 /hbe-learn # 模式学习提取 /hbe-eval # 评估驱动开发 /hbe-academic # 学术研究工作流 ``` ### 📜 规则文件（83 个） | 规则 | 文件 | 何时生效 | |------|------|----------| | **安全规则** | skills/rules/security.md | 涉及密钥/用户输入/API | | **代码风格** | skills/rules/coding-style.md | 编写代码时 | | **测试规则** | skills/rules/testing.md | 写测试时 | | **Git 工作流** | skills/rules/git-workflow.md | git 操作时 | | **代理编排** | skills/rules/agent-orchestration.md | 多Agent协作时 | | **性能规则** | skills/rules/performance.md | 性能优化时 | | **设计模式** | skills/rules/patterns.md | 架构设计时 | | **Hook 规则** | skills/rules/hooks.md | Hook 触发时 | > 💡 规则覆盖 13 种语言（TS/Python/Rust/Go/Java/Kotlin/C#/C++/Dart/Swift/PHP/Perl），可通过 **MCP 规则查询服务** 按需获取，无需全部加载。 ### 🔌 MCP 规则查询服务 HBE 内置一个 MCP server，让 LLM **按需查询** 83 条编码规则，而非全部塞进上下文： ```bash # 构建 MCP server（首次或更新规则后） npm run build:mcp ``` **3 个工具**（LLM 自动调用）： - `list_languages` — 列出支持的语言和规则类别（L0 索引，~50 tokens） - `get_rules(language, category)` — 获取特定语言的规则全文（L2 详情） - `search_rules(query)` — 跨语言全文搜索规则 **效果**：LLM 写 Python 代码前调 `get_rules("python", "security")` 只取相关规则，而非加载全部 5600 行。插件安装后 MCP server 自动注册（见 `.mcp.json` 和各平台 `plugin.json` 的 `mcpServers`）。 ### 🔄 Ralph 自主循环突破 Claude 的 200K token 上下文限制，自动完成大型任务： **核心机制**： - 每次迭代 = 全新上下文起点 - 记忆通过文件持久化（prd.json, progress.md, git history） - 完全自主执行，无需人工干预 - 后台运行，实时查看进度 **工作流程**： ``` 初始化 → 循环（选story → TDD实现 → 验证 → 提交） → 结束 ``` ### 🔗 Hooks 自动化 | Hook | 触发时机 | 行为 | |------|----------|------| | **TypeScript 检查** | 编辑 .ts/.tsx 后 | 实时类型检查 | | **Prettier 格式化** | 编辑代码文件后 | 自动格式化 | | **console.log 警告** | 提交前 | 检测遗留调试语句 | | **PR 创建提示** | gh pr create 后 | 输出 PR URL + review 命令 | | **Git push 提醒** | git push 前 | 提示 review 变更 | --- ## 📁 文件结构 ``` hermes-by-everythings/ ├── README.md # 项目主文档 ├── CHANGELOG.md # 变更日志 ├── LICENSE # 许可证 ├── CLAUDE.md # 核心上下文 ├── SKILLS.md # ⭐ 轻量级路由表 (2KB) │ ├── skills/ # 🎯 统一技能目录 │ ├── active/ # 活跃技能 │ ├── agents/ # 37 个 agent 定义 │ ├── rules/ # 77 个规则定义 │ └── templates/ # 5 个模板 │ ├── docs/ # 📚 文档目录 │ ├── reports/ # 11 个优化报告 │ ├── architecture/ # 9 个架构文档 │ ├── guides/ # 2 个使用指南 │ ├── adr/ # 5 个 ADR │ └── research/ # 研究文档 │ ├── scripts/ # 🔧 脚本目录 │ ├── core/ # 核心脚本 (hooks, ralph, test) │ ├── ai/ # AI 功能 (2 个) │ ├── cache/ # 缓存系统 │ ├── dashboard/ # 监控面板 (2 个) │ ├── performance/ # 性能优化 (2 个) │ └── recovery/ # 错误恢复 │ ├── tests/ # 测试 ├── themes/ # 主题配置 └── schemas/ # Schema 定义 ``` **Token 效率**: SKILLS.md 仅 2KB (vs 原 SKILL.md 15KB，86% 优化) --- ## 快速开始 ### 安装 #### 方式 1: 插件市场安装（推荐，支持 Claude Code / ZCode / Codex） **Claude Code / ZCode:** ```bash # 1. 添加市场 /plugin marketplace add ViewWay/hermes-by-everythings # 2. 安装插件 /plugin install hermes-by-everythings ``` **Codex (OpenAI):** ```bash codex plugin marketplace add ViewWay/hermes-by-everythings codex plugin install hermes-by-everythings ``` 安装后即可使用全部 39 个 Agent、33 个 Skill、18 个 `/hbe-*` 命令。 #### 方式 2: 使用 skillhub ```bash npm install -g @anthropics/skillhub skillhub install hermes-by-everythings ``` #### 方式 3: 使用安装脚本（跨平台） ```bash git clone https://github.com/ViewWay/hermes-by-everythings.git cd hermes-by-everythings # 选择适合平台的脚本 bash install.sh # macOS/Linux python3 install.py # 跨平台（推荐） powershell install.ps1 # Windows ``` #### 方式 4: 手动安装（开发模式） ```bash # 1. 克隆仓库 git clone https://github.com/ViewWay/hermes-by-everythings.git # 2. 创建软链接（开发模式，改动实时生效） ln -s $(pwd)/hermes-by-everythings ~/.claude/skills/hermes-by-everythings # 3. 验证安装 ls -la ~/.claude/skills/hermes-by-everythings ``` 📖 **详细安装指南**: [docs/guides/INSTALLATION.md](docs/guides/INSTALLATION.md) ### 验证安装在 Claude Code 中输入： ``` /hbe-verify --system ``` 预期输出： ``` ✓ HBE 系统验证通过 ✓ 39 个 Agent 可用 ✓ 31 个 Skill 可用 ✓ 22 个 Command 可用 ✓ Orchestrator 编排系统可用 ``` ### 📚 学习资源 - **[安装指南](docs/guides/INSTALLATION.md)** - 完整的安装教程和故障排除 - **[快速开始](docs/guides/quick-start.md)** - 5分钟上手指南 - **[Agent教程](docs/guides/agents/)** - 核心 Agent 的详细使用教程 - **[Orchestrator教程](docs/guides/ORCHESTRATOR-TUTORIAL.md)** - 多Agent编排系统教程 - **[文档索引](docs/INDEX.md)** - 完整的文档导航应该看到： ``` ✓ HBE 系统验证通过 ✓ 39 个 Agent 可用 ✓ 31 个 Skill 可用 ✓ 22 个 Command 可用 ✓ Orchestrator 编排系统可用 ✓ Ralph 自主循环就绪 ``` ### 第一次使用 #### 1. 创建一个简单的计划 ``` /hbe-plan 实现用户登录功能 ``` HBE 将： 1. 分析需求 2. 检查代码库 3. 制定实现计划 4. 输出具体步骤 #### 2. 使用 TDD 开发 ``` /hbe-tdd 实现用户认证 ``` HBE 将： 1. 先写测试（RED） 2. 实现功能通过测试（GREEN） 3. 重构优化（REFACTOR） #### 3. 代码审查 ``` /hbe-review ``` HBE 将： 1. 检查代码质量 2. 识别潜在问题 3. 提供改进建议 --- ## 📖 文档导航 > **快速查找**: [完整文档索引](docs/INDEX.md) | [安装指南](docs/guides/INSTALLATION.md) | [Agent教程](docs/guides/agents/) | [中文文档](README.zh-CN.md) ### 核心文档 | 文档 | 说明 | 适用对象 | |------|------|----------| | **[安装指南](docs/guides/INSTALLATION.md)** | 完整安装教程（skillhub/git/manual） | 所有用户 | | **[快速开始](docs/guides/quick-start.md)** | 5分钟上手指南 | 所有用户 | | **[Agent教程](docs/guides/agents/)** | 核心 Agent 详细使用教程 | 开发者 | | **[Orchestrator教程](docs/guides/ORCHESTRATOR-TUTORIAL.md)** | 多Agent编排系统教程 | 开发者 | | **[集成指南](docs/ORCHESTRATOR-GUIDE.md)** | Orchestrator深度集成 | 架构师 | | **[文档索引](docs/INDEX.md)** | 完整的文档导航 | 所有用户 | | **[变更日志](CHANGELOG.md)** | 版本更新历史 | 维护者 | ### 按主题查找 **核心概念**: - [Agent系统](skills/agents/) - 37个专业Agent - [Skill系统](SKILL-INDEX.md) - 技能索引和路由 - [Orchestrator](docs/ORCHESTRATOR-GUIDE.md) - 多Agent编排 - [Ralph循环](commands/hbe-ralph.md) - 会话内自主循环工作流 - [Memory系统](docs/MEMORY-SYSTEM.md) - 持久化记忆 **开发工作流**: - [TDD工作流](commands/hbe-tdd.md) - 测试驱动开发 - [Agent教程](docs/guides/agents/) - 核心 Agent 使用教程 - [代码审查](docs/guides/agents/CODE-REVIEWER.md) - 代码质量检查 - [安全审查](docs/guides/agents/SECURITY-REVIEWER.md) - 安全漏洞扫描 - [重构清理](docs/guides/agents/REFACTOR-CLEANER.md) - 死代码清理 - [E2E测试](docs/guides/agents/E2E-RUNNER.md) - 端到端测试 **报告和参考**: - [agentdesign集成报告](docs/reports-archive/PHASE2-OPTIMIZATION.md) - 最新集成 - [文档更新报告](docs/reports-archive/DOCUMENTATION-UPDATE-2026-05-02.md) - 文档变更 - [脚本迁移报告](docs/reports-archive/PHASE4-INTERACTIVE-OPTIMIZATION.md) - 跨平台脚本 - [上下文优化](docs/architecture/CONTEXT-OPTIMIZATION.md) - Token优化 --- ## 使用模式 ### 模式 A: 单阶段按需使用用户只调用某个子命令，如 `/hbe-plan`： 1. 从路由表找到对应 Agent 2. 加载 skills/agents/NAME.md 3. 按 Agent 流程执行 4. 输出结果 ### 模式 B: 半自动流水线用户依次调用多个阶段，如 `/hbe-plan` → `/hbe-tdd` → `/hbe-review`： 1. 每个阶段输出 handoff 文档 2. 下一阶段读取上一阶段的 handoff 3. 最终聚合为完整报告 ### 模式 C: 预设工作流 | 工作流 | 触发 | 流水线 | |--------|------|--------| | **feature** | `/hbe-orchestrate feature` | planner → tdd → review → security | | **bugfix** | `/hbe-orchestrate bugfix` | build-fix → tdd → review | | **refactor** | `/hbe-orchestrate refactor` | architect → review → refactor-cleaner → tdd | | **security** | `/hbe-orchestrate security` | security-reviewer → review → architect | | **full** | `/hbe-orchestrate full` | plan → architect → tdd → review → security → docs | ### 模式 D: Ralph 自主循环用户调用 `/hbe-ralph`，进入完全自主模式： 1. 读取 prd.json（如无则先生成: `/hbe-prd`） 2. 循环： - a. 选最高优先级 passes=false 的 story - b. TDD 实现（RED → GREEN → REFACTOR） - c. 运行验证循环 (`/hbe-verify`) - d. 全部通过 → git commit - e. 更新 prd.json passes=true - f. 追加到 progress.md 3. 直到所有 story 通过或达到迭代上限 4. 输出 progress.md 汇总 --- ## 支持的语言和框架 ### 语言覆盖 | 语言 | 框架 | 构建 | 测试 | 详细适配 | |------|------|------|------|----------| | **TypeScript/JavaScript** | React, Next.js, Vue, Svelte, NestJS, Express | tsc/esbuild/turbo | vitest/jest | references/language-adapter.md | | **Python** | Django, FastAPI, Flask, PyTorch | setuptools/hatch | pytest | references/language-adapter.md | | **Rust** | Axum, Actix, Rocket, Tokio | cargo | cargo test | references/language-adapter.md | | **Go** | Gin, Echo, Fiber | go build | go test | references/language-adapter.md | | **Java** | Spring Boot, Quarkus, Micronaut | maven/gradle | junit | references/language-adapter.md | | **Kotlin** | Ktor, Android | gradle | kotest | references/language-adapter.md | | **C#/.NET** | ASP.NET Core, Blazor | dotnet build | xunit/nunit | references/language-adapter.md | | **Ruby** | Rails, Sinatra | rake | rspec | references/language-adapter.md | | **PHP** | Laravel, Symfony | composer | phpunit/pest | references/language-adapter.md | | **Swift** | Vapor, Hummingbird | swift build | xctest | references/language-adapter.md | ### 五阶段验证循环自动检测项目语言，运行对应工具链: **Phase 1 Build** — cargo build / go build / mvn compile / dotnet build / ... **Phase 2 Type Check** — cargo clippy / go vet / mypy / npx tsc --noEmit / ... **Phase 3 Lint** — golangci-lint / ruff / clippy / eslint / rubocop / ... **Phase 4 Test** — cargo test / go test / pytest / vitest / rspec / phpunit / ... **Phase 5 Security** — 密钥检测 + 语言特定安全扫描任一阶段失败则 STOP，修复后从 Phase 1 重新开始。 --- ## 平台兼容性 HBE 支持 macOS/Windows/Linux，兼容 Claude Code、OpenCode、OpenClaw、Hermes 四个平台。 ### 平台能力映射 | HBE 能力 | Hermes | Claude Code | OpenCode | OpenClaw | |----------|--------|-------------|----------|----------| | **加载 Agent** | `skill_view()` | `Read` | `read_file` | `read_file` | | **并行执行** | `delegate_task()` | `Agent[并行]` | `parallel` | `parallel` | | **文件操作** | `read/write_file` | `Read/Write/Edit` | file tools | file tools | | **Hooks** | `hooks.json` | `settings.json` | config | config | | **任务追踪** | `todo()` | `TaskCreate/Update` | task mgmt | task mgmt | ### Hermes 增强能力以下能力仅在 Hermes 平台可用: | 能力 | 说明 | |------|------| | **delegate_task 并行子代理** | 多 Agent 真正并行执行 | | **memory 持久化记忆** | 跨会话记住项目知识 | | **skill_manage 动态技能** | 运行时创建/更新 skill | | **cronjob 定时任务** | 定时触发 /hbe-ralph 自主开发 | | **execute_code 批量操作** | 一次执行多个工具调用 + 中间逻辑 | | **多平台通知** | 微信/Telegram/飞书/Discord 推送 | | **browser 内置浏览器** | 无需外部 MCP 做 UI 验证 | | **vision_analyze 视觉分析** | 截图对比、UI 回归测试 | --- ## 目录结构 ``` hermes-by-everythings/ ├── SKILLS.md # 主入口（命令路由 + 全流程定义） ├── CLAUDE.md # 项目级持久上下文（每次会话自动加载） ├── README.md # 本文件 ├── README.zh-CN.md # 中文版 README ├── CHANGELOG.md # 变更日志 ├── CONTRIBUTING.md # 贡献指南 ├── install.sh # 自动化安装脚本 ├── .claude-plugin/ │ └── marketplace.json # Claude Code marketplace 配置 ├── .claude/ │ └── settings.json # Hooks 和配置 ├── references/ │ ├── agents/ # 参考代理实现 │ │ ├── planner.md │ │ ├── architect.md │ │ ├── code-reviewer.md │ │ ├── security-reviewer.md │ │ ├── tdd-guide.md │ │ ├── build-error-resolver.md │ │ ├── e2e-runner.md │ │ ├── refactor-cleaner.md │ │ ├── doc-updater.md │ │ └── continuous-learning.md # 闭环学习系统 │ ├── rules/ # 83 个规则文件 │ │ ├── security.md │ │ ├── coding-style.md │ │ ├── testing.md │ │ ├── git-workflow.md │ │ ├── agent-orchestration.md │ │ ├── performance.md │ │ ├── patterns.md │ │ └── hooks.md │ ├── orchestration.md # 多Agent编排流程 │ ├── platform-adapter.md # 4平台适配层 │ ├── language-adapter.md # 10语言工具链映射 │ └── token-optimizer.md # Token优化策略 ├── skills/ # 技能分类目录 │ ├── active/ # 活跃技能 │ ├── experimental/ # 实验性技能 │ └── deprecated/ # 已废弃技能 ├── templates/ # 输出模板 │ ├── skill-template.md # Skill 模板 │ ├── agent-template.md # Agent 模板 │ ├── command-template.md # Command 模板 │ ├── prd-json.json # PRD JSON 格式 │ ├── handoff.md # Agent 交接文档 │ └── progress.md # 进度追踪模板 ├── scripts/ │ ├── hooks/ # Hook 脚本 │ │ ├── session-start.js # 会话启动 │ │ ├── block-no-verify.js # 拦截 git --no-verify │ │ └── _ecc/, _optional/ # 分类 hook 子目录 │ ├── core/ # 核心子系统 │ │ ├── ralph/ralph.js # Ralph 编排器骨架 │ │ └── hooks/ # auto-learn.sh, file-type-detect.sh │ ├── test/ # 测试套件 │ │ ├── test-all.sh # 运行所有测试 │ │ ├── test-skills.sh # 测试技能格式 │ │ └── validate-prompts.sh # 验证 Prompt 质量 │ ├── lib/ # 工具库 │ │ └── detect-pm.sh # 包管理器检测 │ └── verify-loop.sh # 多语言五阶段验证循环 ├── docs/ # 文档目录 │ ├── adr/ # 架构决策记录 │ │ ├── 0000-template.md │ │ ├── 0001-skill-organization.md │ │ ├── 0002-ralph-integration.md │ │ ├── 0003-learning-loop.md │ │ └── README.md │ ├── guides/ # 使用指南 │ │ └── quick-start.md # 快速开始 │ ├── api/ # API 参考 │ ├── SKILL-PLACEMENT-POLICY.md # 技能放置策略 │ └── repo-analysis-report.md # 仓库分析报告 └── tests/ └── validate-prompts.sh # Prompt质量验证脚本 ``` ### Ralph 运行时生成的文件（在项目根目录） ``` 项目根目录/ ├── prd.json # 用户故事列表（任务清单） ├── progress.md # 迭代学习记录 ├── .ralph-state.json # 运行统计（tokens, 耗时） ├── .ralph-checkpoint.json # 最近检查点 ├── .ralph-log.jsonl # 详细日志 └── memory/ # 学习记忆目录 ├── errors/ # 错误模式 ├── successes/ # 成功模式 ├── feedback/ # 用户偏好 ├── project/ # 项目特定 └── platform/ # 平台差异 ``` --- ## Token 消耗预估 | 模式 | 预估 tokens | |------|-------------| | 单命令（如 `/hbe-plan`） | 5-15k input + 2-5k output | | 三阶段流水线 | 30-50k total | | Ralph 1 次迭代（优化后） | 10-18k | | Ralph 全流程 10 次（优化后） | 100-180k | | 完整 feature 工作流 | 50-80k | | 安全审查 + 修复 | 15-30k | **Token 优化策略**： - 分层加载（L0-L6），按需加载 - Hash 缓存，避免重复读取 - 战略压缩（>100k tokens 或 >20 轮时触发） - Delta diff，而非完整文件总体节省约 **55%** tokens。 --- ## 测试 ### 运行测试 ```bash # 运行所有测试 bash scripts/test/test-all.sh # 运行单个测试 bash scripts/test/test-skills.sh # 测试技能格式 bash scripts/test/test-agents.sh # 测试 Agent 格式 bash scripts/test/test-hooks.sh # 测试 Hooks ``` ### 验证 Prompt 质量 ```bash # 验证所有 Prompt 质量 bash scripts/test/validate-prompts.sh ``` 质量评分标准： - **80-100 分**: 优秀，符合 Active 标准 - **60-79 分**: 良好，需要改进 - **0-59 分**: 不合格，需要重新编写 --- ## 贡献欢迎贡献！请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。 ### 贡献流程 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'feat: add AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 创建 Pull Request ### 代码规范 - **文件命名**: `lowercase-with-hyphens.md`（如 `python-reviewer.md`） - **Commit 消息**: 遵循 [Conventional Commits](https://www.conventionalcommits.org/) - `feat:` 新功能 - `fix:` Bug 修复 - `docs:` 文档更新 - `refactor:` 重构 - `test:` 测试 - `chore:` 构建/工具 ### 重要决策重要架构决策需要通过 ADR 流程： 1. 复制 ADR 模板：`cp docs/adr/0000-template.md docs/adr/0004-your-decision.md` 2. 填写所有章节 3. 在 PR 中讨论 4. 被接受后合并 --- ## 常见问题 ### Q: HBE 与 everything-claude-code 有什么区别？ **A**: HBE 整合了 everything-claude-code 的全面能力和 ralph 的自主循环特性，专注于提供一个更加精简、高效的多平台多语言编码增强套件。HBE v2.1+ 新增了闭环学习系统、百分百触发机制、无人值守推进等特性。 ### Q: Ralph 是如何规避上下文限制的？ **A**: Ralph 通过每次迭代使用全新的上下文起点，并将任务状态通过文件系统持久化（prd.json, progress.md, git history）来规避单次会话的 200K token 限制。真实入口是 `/hbe-ralph` 命令——它在 Claude Code 会话内执行 WHILE 循环（读取未完成 story → TDD 实现 → 增量验证 → commit → 更新状态）。`scripts/core/ralph/ralph.js` 是一个 Node 编排器骨架，预留了 cron/无人值守场景的接入点。 ### Q: 如何在不同平台间迁移？ **A**: HBE 提供了 `references/platform-adapter.md` 适配层，可以在 Claude Code、Hermes、OpenCode、OpenClaw 之间无缝迁移。核心 Agent prompts 和规则文件是平台无关的纯文本 Markdown。 ### Q: 学习系统是如何工作的？ **A**: 学习系统通过 `scripts/hooks/auto-learn.sh` 在会话结束时自动提取可复用模式，分类存储到 `memory/` 目录，并在模式复用 3 次后自动生成新的 Skill。详见 `skills/agents/continuous-learning.md`。 ### Q: 如何添加自定义技能？ **A**: 有三种方式： 1. **手动创建**: 在 `skills/active/` 创建符合模板的 Skill 2. **自动学习**: 使用 `/hbe-learn` 自动提取模式 3. **项目特定**: 在 `~/.claude/skills/project-specific/` 创建项目专属技能详见 [技能放置策略](docs/SKILL-PLACEMENT-POLICY.md)。 --- ## 更新日志 ### v3.3.1 (2026-06-19) - 三平台插件市场 + Drift 修复 **重大更新**： - ✅ **三平台插件市场支持** - Claude Code / ZCode / Codex 可通过 `/plugin marketplace add` + `/plugin install` 安装 - ✅ **插件清单** - 新增 `.claude-plugin/`、`.zcode-plugin/`、`.codex-plugin/` 三套清单（共享 skills/commands/hooks） - ✅ **命令 frontmatter 适配** - 18 个命令补全 `argument-hint` + `skills` 标准字段 - ✅ **hooks 重写** - 基于真实 hooks 重写 `hooks/hooks.json` 为三平台标准格式 **修复**： - 🔧 **文档 drift** - 统一 agent(37)/skill(33)/command(18)/rule(77) 实际数量到所有入口文档 - 🔧 **断链修复** - `.claude/skills` 和 `skills/academic-research` 断链（硬编码 `~/github/` 旧路径） - 🔧 **install.sh** - 补全未定义变量 `TEMP_DIR/REPO_URL/INSTALL_DIR`，清理旧命名残留 - 🔧 **drift 检查测试** - 新增 33 个测试防止版本号/数量/断链 drift 复发 ### v3.3.0 (2026-05-02) - 市场安装 + 完整测试框架 **重大更新**： - ✅ **npm 市场支持** - 可通过 `npm install -g hermes-by-everythings` 安装 - ✅ **完整测试框架** - 44 个测试，覆盖 agents/skills/documentation - ✅ **HBE CLI 工具** - `npx hbe status/agents/skills/test` 命令 - ✅ **智能安装脚本** - 自动检测 Claude Code，一键安装 **新增 Agents** (17 个 ECC agents)： - **P0 关键** (5): loop-operator, python-reviewer, typescript-reviewer, go-reviewer, harness-optimizer - **P1 重要** (4): code-explorer, docs-lookup, performance-optimizer, database-reviewer - **P2 增强** (5): flutter-reviewer, rust-reviewer, rust-build-resolver, pytorch-build-resolver, type-design-analyzer - **P3 专用** (3): silent-failure-hunter, seo-specialist, comment-analyzer **新增 Hooks** (65+ 文件)： - 会话管理 (7): session-start-bootstrap, session-end-marker, session-activity-tracker - 质量门控 (5): quality-gate, design-quality-check, check-console-log, doc-file-warning, config-protection - 自动化 (8): bash-hook-dispatcher, plugin-hook-bootstrap, governance-capture, observe-runner - 后编辑处理 (4): post-edit-accumulator, post-edit-console-warn, post-edit-format, post-edit-typecheck - Git 集成 (3): pre-bash-commit-quality, pre-bash-git-push-reminder, post-bash-pr-created **文档更新**： - ✅ AGENTS.md - 完整的 36 个 agents 目录 - ✅ COMMANDS-QUICK-REF.md - 命令快速参考 - ✅ CHANGELOG.md - v3.3.0 详细变更记录 - ✅ docs/marketplace/ - 市场安装指南 - ✅ docs/testing/ - 测试框架文档 **项目整洁**： - ✅ 删除所有备份文件 - ✅ 添加 .npmignore 和 .gitignore - ✅ 统一版本号到 v3.3.0 - ✅ 更新仓库地址到 ViewWay/hermes-by-everythings ### v2.1.0 (2026-05-02) - Phase 1 优化完成 **新增**: - ✅ 百分百触发机制 - ✅ 闭环学习系统 - ✅ 无人值守推进 - ✅ 自我更新学习 - ✅ 纯净上下文管理详见 [IMPLEMENTATION-SUMMARY.md](docs/reports-archive/IMPLEMENTATION-SUMMARY.md)。 ### v2.0.0 (2026-04-22) - 初始版本 - 39 个专业代理 - 33 个核心技能 - 18 个快捷命令 - 83 个规则文件 - Ralph 自主循环 --- ## 参考资源 - **灵感来源**: [burn-in-cceverywhere-ralph](https://github.com/hellangleZ/burn-in-cceverywhere-ralph) - **原始 Ralph**: [ralph](https://github.com/snarktank/ralph) - **everything-claude-code**: [everything-claude-code](https://github.com/affaan-m/everything-claude-code) - **Hermes Agent**: [Hermes](https://github.com/nicepkg/hermes) ### 学习的优质仓库基于以下 4 大优质仓库的最佳实践： 1. [mattpocock/skills](https://github.com/mattpocock/skills) - 工程化个人技能集 2. [anthropics/skills](https://github.com/anthropics/skills) - 官方技能规范 3. [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) - 全功能套件 4. [hellangleZ/burn-in-cceverywhere-ralph](https://github.com/hellangleZ/burn-in-cceverythings-ralph) - Ralph 集成详见 [仓库分析报告](docs/research/repo-analysis-report.md)。 --- ## 许可证 MIT License - 详见 [LICENSE](LICENSE) 文件 --- ## 致谢感谢以下项目和社区： - [Anthropic](https://www.anthropic.com/) - Claude Code 和 Claude API - [affaan-m](https://github.com/affaan-m) - everything-claude-code - [snarktank](https://github.com/snarktank) - ralph - [hellangleZ](https://github.com/hellangleZ) - burn-in-cceverythings-ralph - [mattpocock](https://github.com/mattpocock) - skills - [所有贡献者](https://github.com/ViewWay/hermes-by-everythings/graphs/contributors) --- ## 联系方式 - **GitHub Issues**: [报告问题](https://github.com/ViewWay/hermes-by-everythings/issues) - **GitHub Discussions**: [讨论](https://github.com/ViewWay/hermes-by-everythings/discussions) - **Email**: support@hermes-by-everythings.com --- <div align="center"> **Made with ❤️ by the Hermes-by-Everything team** [⭐ Star us on GitHub](https://github.com/ViewWay/hermes-by-everythings) • [🐛 Report bugs](https://github.com/ViewWay/hermes-by-everythings/issues) • [💡 Request features](https://github.com/ViewWay/hermes-by-everythings/issues/new) </div>

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات محللو ضمان جودة البرمجيات والمختبرون

٢ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

hermes-by-everythings

مطوّرو البرمجيات

多平台多语言编码增强套件。整合 ECC + Ralph 最佳能力。 22 Command + 39 Agent + 自动化 Hooks + 学习系统。支持 TypeScript/Python/Rust/Go/Java/Kotlin 等10种语言。

لغة النص الأصلي: الصينية

2026-06-19

code-review

محللو ضمان جودة البرمجيات والمختبرون

Systematic code review patterns covering security, performance, maintainability, correctness, and testing

لغة النص الأصلي: الإنجليزية

2026-06-19

diagram

مطوّرو البرمجيات

Generate diagrams from descriptions with Mermaid, PlantUML, or ASCII for architecture, flows, sequences, and data models.

لغة النص الأصلي: الإنجليزية

2026-05-01

عرض ٣ من أصل ٣ skills مجمعة.