Community编程与开发github.com

Apartment38/Agent-Skills

用于维护 Hermes 皮肤。确保所有颜色项完整。

Agent-Skills 是什么?

此技能旨在审计、扩展或修复已有的 Hermes 皮肤,确保其在 CLI、TUI 和桌面应用中保持视觉一致。核心依赖 `apps/shared/src/skin.ts` 中的 `SKIN_COLOR_TOKENS` 作为跨表面色彩契约,并以此为标准衡量皮肤的颜色覆盖度。技能提供了一套规范化流程:先加载主题指南、解析目标皮肤的 YAML,然后从仓库获取并解析最新令牌列表,计算出缺失的键并添加,同时根据语义家族(如 background、primary、diff 等)分配合理的新颜色。最后会验证 YAML 合法性,并通过 `hermes config` 命令应用皮肤并确认结果。该技能支持 Hermes Agent 仓库中的皮肤维护,适用于开发者快速审核和修复皮肤,确保符合最新色彩规范。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Apartment38/Agent-Skills/tree/HEAD/autonomous-ai-agents/hermes-skin-maintenance

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Hermes 皮肤维护

使用此技能来审计、扩展或修复现有的 Hermes 皮肤,同时保持其在 CLI、TUI 和桌面应用中的视觉特征。

权限与范围

  • 跨表面颜色契约的规范来源是 Hermes Agent 仓库中 apps/shared/src/skin.ts 文件内的 SKIN_COLOR_TOKENS。从用户指定的分支获取该原始文件,未指定修订时使用 main。
  • 一个皮肤可以包含遗留或小众键,但令牌覆盖率必须仅以规范列表为衡量标准。不要仅仅因为额外键不在该列表中而删除它们。
  • 从 $HERMES_HOME 环境变量解析活跃的 Hermes 主目录;如果未设置,则使用 ~/.hermes。切勿手动编辑 config.yaml。

流程

  1. 加载 Hermes 主题指南(如果可用),并检查目标皮肤的 YAML 文件。
  2. 获取并解析 SKIN_COLOR_TOKENS;不要从旧模板推断列表。
  3. 通过皮肤 colors 映射程序化地计算出缺失的键。
  4. 仅添加缺失的规范键。保留现有值,并根据语义族分配新颜色,而不是发明无关的色调:
    • background:符合已有皮肤基调的深色或浅色底色。
    • primary/text/border:重用现有的标题、正文和结构调色板。
    • tool/thinking:继承皮肤的主体强调色和次要标签颜色,除非存在有意的对比区分。
    • diff/status/syntax:将 positive→ok、warning/number→warn、negative→error 进行映射;对于单词级别的差异和关键状态,使用稍强的色调。
    • terminal chrome:一致地重用提示符、强调色和文本层次结构。
  5. 所有颜色值保持为带引号的六位十六进制格式,如 #rrggbb。
  6. 验证 YAML,并确保每个规范令牌都已存在。
  7. 使用 hermes config set display.skin <name> 应用编辑后的皮肤,并在报告成功前使用 hermes config get display.skin 确认。

验证检查清单

报告以下确切检查项:

  • 目标文件路径与内嵌的皮肤 name 一致。
  • YAML 解析成功。
  • missing_tokens=none(与获取到的规范 SKIN_COLOR_TOKENS 对比)。
  • 激活的皮肤在应用后解析为目标名称。

注意事项

  • 皮肤现有的调色板可能有意省略 background;但添加它对于可靠的桌面/TUI 基础表面渲染仍然是必要的。
  • status_bar_bad 和 status_bar_critical 是不同的项。不要止步于旧版、较小的模板调色板。
  • 在同一会话中更改配置的模型提供者时,在选择 OAuth 提供者后需移除继承的自定义 model.base_url;否则旧本地端点可能保留在配置中。在声明迁移完成前确认所选提供者的认证状态。
  • 不要修改捆绑的或用户拥有的 Hermes 技能。请创建或更新由维护者管理的配套技能。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能