character-card-v3-generator について
ロールプレイ用のCharacter Card V3 JSONを作成・更新するスキルです。キャラクターの振る舞い、ロアブック、任意のカード単位スクリプトを扱い、仕様に沿ったテンプレートやガイドを提供して構造を検証します。
主な機能
- 01CCv3カードの作成と更新
- 02発動条件付きロアブックの構築
- 03キャラクター執筆ガイドの適用
- 04カード単位の正規表現スクリプトに対応
- 05JSON構造の検証
活用シーン
- 01ロールプレイ用キャラクターカードの作成
- 02既存カードをCCv3に変換
- 03設定を発動条件付きエントリーに整理
- 04納品前のカード確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ inkandale/ sillytavern-skills --skill character-card-v3-generatorインストール後、Claude Code で/character-card-v3-generatorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlassets/templates/advanced-card-v3.jsonminimal-card-v3.jsonstandard-card-v3.jsonexamples/command-orchestration-pattern.mdformat-comparison.mdsecret-reveal-pattern.mdreferences/character-writing-guidelines.mdformat-options.mdimage-and-asset-formats.mdlorebook-guidelines.mdmulti-character-and-scenarios.mdpopular-card-patterns.mdregex-scoped-scripts.mdreviewing-cards.mdsource-notes.mdspec-v3-field-map.mdscripts/validate_card.py詳細
Character Card V3 ジェネレーター
概要
ロールプレイ向けに、仕様に準拠した高品質な Character Card V3 の JSON 出力を生成します。明確な行動アンカー、実用的な有効化ロジック、チャット内で予測しやすい動作を備えたカードとロアブックを作成します。
ワークフロー
- 依頼内容を明確にします。
- ジャンル、トーン、厳守する境界、
{{user}}との関係、チャットスタイル(短文/長文)、希望する動作上の制約を把握します。 - 出力に最小、標準、高度のどのテンプレートを使うか尋ねます。
- ユーザーが選択しない場合は、
standardを既定値とします。
- CCv3 の骨組みを作成します。
- 新規カードの場合は、
assets/templates/を基にして、まず必須フィールドを埋めます。 - 変換やアップグレードの場合は、既存のカードを読み込んでから、最小限の差分で CCv3 に変換します(CCv3 の構造と矛盾しない限り、既存の意図や内容を維持します)。
- カードの構造に偏りがある場合は、
references/popular-card-patterns.mdの正規化パターン(フィールドの再配分、トリガーの整理、ロアエントリーの分割)を適用します。 - スタイルの詳細を追加する前に、スキーマ上重要なフィールドを有効な状態に保ちます。
- 必須フィールドの動作については、
references/spec-v3-field-map.mdを参照します。
- 重要度の高いキャラクター設定を記述します。
references/character-writing-guidelines.mdを適用します。- 冗長な文章よりも、安定したアイデンティティ、行動上の制約、具体例を優先します。
references/spec-v3-field-map.mdを使い、system_promptとpost_history_instructionsを主要な制御手段として設計します。- 継続的に適用されるルールは
system_promptに、最後のターンでの誘導や徹底はpost_history_instructionsに記述します。
- ロアブックの方針を設計します。
references/lorebook-guidelines.mdを使い、エントリーキー、有効化する深さ、トークン予算、挿入順序を決めます。- 1 つのエントリーにつき 1 つの概念を扱い、観察された失敗を基に段階的に追加する方法を優先します。
- 必要に応じて、カードに紐づく正規表現スクリプトを追加します(SillyTavern 固有)。
data.extensions.regex_scriptsの構造と例については、references/regex-scoped-scripts.mdを使用します。- このキャラクターカードに紐づけるべき、決定的なテキスト変換にのみ使用します。
- 正規表現スクリプトは最小限にとどめ、提供前に会話のサンプルでテストします。
- 出力を検証します。
- 構造チェックには
scripts/validate_card.py <path-to-card.json>を実行します。 - ロアトリガーを、ユーザーが使いそうな表現に照らして手動で確認します。
references/reviewing-cards.mdを使って品質チェックを行います。
- 成果物を返します。
- 最終的な CCv3 JSON を返します。
- 主な設計上の選択とトレードオフについて、JSON ブロックの外に別セクションとして短い説明を添えます。
出力ルール
- 常に有効な JSON を出力し、疑似 JSON は出力しません。
- 解説も提供する場合は、JSON 成果物の外に記述します(たとえば、JSON はフェンス付きブロックに、根拠は別の文章セクションに記載します)。
- 明示的に別の指定がない限り、
specは"chara_card_v3"、spec_versionは"3.0"のままにします。 - 非標準のアプリデータには
extensionsを使用し、無関係なトップレベルフィールドの追加は避けます。 - ロアブックのエントリーは簡潔で、実用的な内容にします。
- 仕様上の厳密な制約と、モデルの動作に関するヒューリスティックを区別します。
- XML コメントなどの隠し状態パターンを使用する場合は、情報漏洩のリスクに関する注意書きを含め、チャットレベルでのテストを推奨します。
リソース
references/spec-v3-field-map.md- 必須/任意の CCv3 フィールドと主要な制約。
references/image-and-asset-formats.md- PNG/APNG/JSON/CHARX の扱いと、実用的な画像アセットの互換性ルール。
references/character-writing-guidelines.md- 実用的なキャラクター執筆の品質評価基準。
references/lorebook-guidelines.md- ロアブックのエントリー設計、トリガーの品質、トークン戦略。
references/multi-character-and-scenarios.md- 群像キャスト、ときどき登場する NPC、構造化されたワールドイベントのロジックに関するパターン。
references/popular-card-patterns.md- 利用頻度の高いカードから導き出した、一般化された品質パターンと正規化の戦略。
references/source-notes.md- リンク先のコミュニティディスカッションから一度だけ収集したヒューリスティック。
references/reviewing-cards.md- リリース準備状況を確認するための品質レビュー用チェックリストと評価基準。
references/regex-scoped-scripts.md- SillyTavern のカードスコープ付き正規表現スキーマ、例、安全対策。
references/format-options.md- Prose、Attributes、AliChat、JED/JED+、Plaintext、W++ の比較と、用途に応じたガイダンス。
examples/format-comparison.md- 主要な各フォーマットで同じキャラクターのコンセプトを示し、すばやく横並びで学習できます。
examples/command-orchestration-pattern.md- 重み付けされた結果と一時的なクリーンアップを含む、コマンドでトリガーされるロアブックアクションの汎用テンプレート。
examples/secret-reveal-pattern.md- 公開情報と秘密情報の分離、遅延公開、信念と事実の階層化、開示頻度の制御。
assets/templates/minimal-card-v3.json- すばやい生成に使える、シンプルなスターターテンプレート。
assets/templates/standard-card-v3.json- ロアブックを含む、バランスの取れたスターターテンプレート。
assets/templates/advanced-card-v3.json- 多言語のメモとアセットを使った、拡張版スターターテンプレート。
scripts/validate_card.py- カード JSON 用の軽量な構造バリデーター。
注意事項
- コミュニティの手法は、フロントエンドやモデルファミリーによって異なる場合があります。ヒューリスティックを適用したうえで、テストチャットを通じて調整してください。
- 制限された環境からは、一部の Reddit スレッドにアクセスできない場合があります。アクセスできない場合は、保守的なガイダンスを維持し、仕様で裏付けられた動作を優先してください。
コメント
Markdown 対応