Hermes スキンメンテナンス
このスキルを使用して、既存のHermesスキンを監査、拡張、または修復し、CLI、TUI、デスクトップアプリ間でそのビジュアルキャラクターを維持します。
権限と範囲
- 正規のクロスサーフェスカラーコントラクトは、Hermes Agentリポジトリの
apps/shared/src/skin.tsにあるSKIN_COLOR_TOKENSです。ユーザーが指定したブランチ、またはリビジョンが指定されていない場合はmainから生のファイルを取得してください。 - スキンにはレガシーまたはニッチなキーが含まれている場合がありますが、トークンカバレッジは正規のリストに基づいてのみ測定します。そのリストに存在しないという理由だけで、互換性のある追加キーを削除しないでください。
- アクティブなHermesホームディレクトリは
$HERMES_HOMEから解決します。設定されていない場合は~/.hermesを使用します。config.yamlを直接編集しないでください。
手順
- Hermesテーマ設定ガイダンスが利用可能な場合はそれを読み込み、対象のスキンYAMLを検査します。
SKIN_COLOR_TOKENSを取得して解析します。古いテンプレートからリストを推測しないでください。- スキンの
colorsマッピングから、欠落しているキーをプログラムで計算します。 - 不足している正規キーのみを追加します。既存の値は保持し、新しい色は無関係な色相を発明するのではなく、セマンティックファミリーに基づいて割り当てます。
background: 確立されたスキンに適合する暗いまたは明るいベース。- primary/text/border: 既存の見出し、本文、構造パレットを再利用。
- tool/thinking: 意図的なコントラストの区別が存在しない限り、スキンのアクセント色とセカンダリラベル色を継承。
- diff/status/syntax: positive→ok、warning/number→warn、negative→error にマッピング。単語レベルの差分と重大なステータスには、わずかに強い色合いを使用。
- terminal chrome: prompt/accent/text の階層を一貫して再利用。
- すべての値は引用符で囲まれた6桁の
#rrggbbカラーとして保持します。 - YAML を検証し、すべての正規トークンが存在することを確認します。
- 編集したスキンを
hermes config set display.skin <name>で適用し、成功を報告する前にhermes config get display.skinで読み戻します。
検証チェックリスト
以下の正確なチェックを報告します。
- 対象ファイルのパスと埋め込まれたスキン
nameが一致している。 - YAML が正常にパースできる。
- 取得した正規の
SKIN_COLOR_TOKENSに対してmissing_tokens=noneである。 - アクティブなスキンが適用後にターゲット名に解決される。
注意点
- スキンの既存パレットは意図的に
backgroundを省略している可能性がありますが、信頼性の高いデスクトップ/TUIベースサーフェスレンダリングのために追加は必要です。 status_bar_badとstatus_bar_criticalは異なるものです。古くて小さいテンプレートパレットだけで止めないでください。- 同じセッション内で設定されたモデルプロバイダーを変更する場合、OAuth プロバイダーを選択した後、継承されたカスタム
model.base_urlを削除してください。そうしないと、古いローカルエンドポイントが設定に残る可能性があります。移行完了を宣言する前に、選択したプロバイダーの認証ステータスを確認してください。 - バンドルされている、またはユーザー所有のHermesスキルを変更しないでください。代わりに、キュレーター管理のコンパニオンスキルを作成または更新してください。