AGENTS.md git:20261027.1a80044A

Immutable. This exact content never changes and is served at /api/v1/blob/93337782c6fb3485.

# 3DCharaMakeSkills-Lida の保守

- ここは配布用の手順・図解・AIスキルの正本。実モデル、受領素材、未整理の検証記録は制作ワークスペースへ残す。
- 制作途中・候補・局所検収・ユーザー採用・全身合流・保存・使用先を区別する。日次の最新候補番号をREADMEの主題にしない。
- 初心者には素材・順番・調整方法・つまずきを簡潔に伝える。詳細は専用文書へ集約し、工程索引から参照する。リダの好みは短いあとがきへ。
- 制作初回は用途・距離・動作・使用先に合う品質案と推奨理由を提示する。各工程の開始時は到達状態・比較条件・終了条件・提出物・残件を短く決めて記録する。既存のユーザー指定を引き継ぎ、通常作業で再承認を繰り返さない。詳細は品質とゴールの専用文書へ。
- 掲載する図はリダ自身のモデルと自作図解。外部モデルの画像・名称・混在比較図、ローカル絶対パス、個人情報、認証情報は入れない。図版の文字と出所は目視でも確認する。
- 数値・本数・担当モデルの観察を普遍的な推奨値や性能順位にしない。各制作のユーザー指定を優先する。
- 2026-10-15の最新ユーザー評価では、ビジュアルも加味したモデリング修正はOpus 5.5が良く、最終的に任せることが多かった。以前のAstra優先は当時の評価として扱う。担当の使い分けと未確認範囲は `skills/lida-avatar-workflow/references/ai-instructions.md` に集約する。
- 図解は専用章へ置き、工程索引・図解索引から参照する。PNGとSVGを対応させ、向き・線・固定部・模式図/実診断の役割を図内に記す。層や隣接列の順序を描画後にも確認する。
- 変更後は `python scripts/validate.py`、`python -m unittest discover -s tests`、`python scripts/build_package.py` を実行。新しい収録物はmanifestへ明示する。変更理由・確認範囲をCHANGELOGへ残す。
- GitHubへの通常更新は依頼の範囲で行う。公開範囲変更とライセンス変更はユーザーの明示指示に従う。公開準備だけから公開の許可を推定しない。2026-10-15に、このSkillsリポジトリの一般公開はユーザーが明示的に指示した。別管理のシェーダーの公開範囲へ自動適用しない。

## 2026-10-21 制作参照モデルの別添配布

- ユーザー指定のチャイナ和服新キャラ r35を完成参照として追加し、公式Releaseの参照専用ZIPとして配布することを明示承認。通常のSkills ZIPにモデルを混ぜず、別添モデルの再配布・改変販売禁止とSkills/GPLの条件を分ける。
- VRMの公開用メタデータを整合して作者名はLidaに統一。元モデルは変更せず、BINとJSONのメタデータ外一致を検査。画像・揺れ・表情は保持、参考モーションは収録しない。三角面を元の編集用網目、モデル完成を全エンジンの合格と誤解しない。

## 知見の蓄積（全ワークスペース共通）

再利用可能な気づきは、作業を終える前にこのワークスペースのAGENTS.mdへ固有の事実を残し、各制作者の管理するVaultの `50_プロジェクト/エージェント環境/90_気づき・改善ログ/YYYY-MM.md` に横断知見を追記する。月次書式はそのフォルダのREADME。既存月次内容とミラーは編集しない。制作固有の入力・数値・採否は制作プロジェクトへ、汎用の判断はスキルと参照文書へ反映する。個人名の取得・転記はせず、呼称はLida/リダを使う。

## 2026-10-15 翼を一から作る専用工程
- 1.1.0で翼の素材・支持体・羽列・接続・網目とウェイト・制御・揺れ・保存出力を専用章へ集約。手順と羽配置の2図を追加し、根元図と合わせて工程ごとのゴールと具体的なAI依頼へ接続する。
- 制作の初期試作を最終構成と取り違えない。後続で骨・ウェイトへ再設計された経路を確認し、旧方式の失敗は原因と次回の指示として使う。初期の設計上の役割分担と最終の制御対象も照合する。
- 根元中心の包含だけでは面の付着を保証しない。支持体の局所断面、羽の根元幅・向き・傾き、隣接雨覆の対応、共通追従を一組で確認する。骨数・羽数・角度値を汎用の固定値にしない。

## 2026-10-15 自作制作補助ツールと眼球工程
- 1.2.0で制作側Toolkitの汎用処理を新しい `scripts/lida_model_tools.py` へ再構成。常駐ハンドラや固有パネルを登録せず、明示した対象の監査、snapshot/compare、別候補へのウェイト正規化を工程から呼び出す。
- 読むだけで実行しない。使用可能なBlenderと対象・リグ・入力版・新規出力先を確認し、処理結果と未検査項目を読む。監査の完了を造形・動作・全依存の合格へ広げない。
- 既存出力を上書きせず、未割当/不正値/ロック矛盾を自動補完しない。候補には元とコピーが共存するため、JSONの名前で片方ずつ表示して検品する。source SHAとメモリ内の保存済み状態を混同しない。
- Blender用新コードはGPL-3.0-or-later、文書・図解は従来の条件。スキル内にもGPL本文を同梱し、独自条件をGPLコードへ上乗せしない。
- 眼球は専用章に球面・目の画像・頭固定の線・視線・表情・出力を集約。瞳孔は作例では画像、薄い角膜面は任意で出力では除外した経路を区別する。自動眼球生成を同梱機能としない。

## 2026-10-14 統合と確認資料の保存版対応
- 0.1.3-devで、入力版・関節/ウェイト・法線/制御依存、完全一致と許容差、保存モデルと画像/動画の版照合をreferences/visual-handoff.mdへ集約。日次モデル番号や私的な制作パスは配布へ入れない。
- Tポーズに見える状態とTの基準姿勢、揺れ設定の保存/書き出しと実時間確認を区別する。動画は実秒数・動作範囲・入力版で判定し、目標の秒数をそのまま実績へ写さない。
- 同じファイル名の修正・再保存後も、影響する画像/動画を再生成するか旧版と明記。合格要約は実測値・事前許容差・例外と照合する。

## 2026-10-14 揺れ設計と書出し範囲
- 0.1.4-devでsecondary-motion.mdへ固定根元/揺れる先端、部位別調整、出力用コピーでのリグ統合、設定保存/構築/ベイク/実使用を集約。入口と工程索引から必要な時だけ参照する。
- 独自の角度制限・慣性・片側制限は自動で出力先へ移ると扱わない。動画末尾の強制フェードは自然収束と分け、代表時刻の接触検査を全時刻の合格へ広げない。

## 2026-10-15 陰影診断・焼き込み・最終確認
- 0.1.5-devでAOの斑と暗さ、追加髪の重複UVをadjustment-methods.mdへ、実VRM読み戻しと指定区間の検品をvisual-handoff.mdへ集約。工程索引・AI指示・失敗表から接続する。
- 共有材質の局所補正は他部品への波及を確認し、出力用コピーで材質・UV・焼き込み先を分けて原本を保持する。作例の平滑化回数・暗さは既定値にしない。
- 最大変位量の一致を全頂点一致へ、画像寸法の統一を軽量化の合格へ広げない。最終動画はユーザー指定の長さと自然な組合せを使い、一旦完了の成果と既知制限を分けて引き渡す。

## 2026-10-15 配布条件・出典・シェーダー分離
- 1.0.0でLICENSE/NOTICEをrootとスキル内へ同文で同梱。手順を読んでモデル等を作る場合は成果物クレジット不要。公開アプリ/派生Skillsには出典情報を残すAI手順と、資料自体の再利用条件を分けて記載する。
- スキルを読んだだけで他プロジェクトへ書き込まない。公開物を作る依頼の範囲でREADME/About/NOTICEへ出典を実際に書き、指定先だけへ補助ツールを適用する。
- 参考ダンスFBX・改名コピー・変換参考モーションは収録しない。収録一覧、ライセンス/出典、版一致、画像署名/ハッシュ、完成ZIP内容を検査する。
- LidaAngelToonは任意取得の別配布。0.2.0からBlender/Unity/UEの実装をまとめ、各実装の検証範囲を分ける。ファイル別ライセンスを優先し、キャラやモデル本体の利用権は本資料の条件に含めない。

## 2026-10-15 生成サービスの前提と商用利用
- 1.0.1で、画像からの新規制作はTripoなどでベース／参考モデルを生成し、Blenderなどで修正・仕上げる流れをREADMEとスキル入口・入力素材へ明記。既存モデルの修正に再生成を必須化しない。
- ユーザー指示により商用利用を制限しない。モデル販売・受託・商用アプリ／派生Skillsも可能で、従来の出典保持条件は共通。生成サービスや第三者素材の条件は別途確認する。LICENSEは既に商用を許諾しており変更なし。
- READMEに既存の自作PNG2枚を本文幅で表示し、素材設計の予防案と口型の模式図を完成結果と誤解しないキャプションを付けた。新しい外部画像や参考モーションは収録しない。

## 2026-10-15 実モデルの仕上がりを入口で見せる
- 図解だけでは作れる品質がすぐ伝わらないとのユーザー指摘により、1.0.2でREADME冒頭へ実モデルの全身・顔を並べる。制作時のBlender描画を使い、生成イラストへ置き換えない。実例と模式図を区別する。
- 実例の入力版と後続の採用判断を制作記録で照合し、古い候補・別材質・別環境を完成例へ混ぜない。表示条件と生成後の調整をmedia/README.mdへ記載する。
- PNGの撮影情報にあるローカルパス等を除き、画素と色の表示情報は保持する。元と配布画像のSHA・画素一致は制作側に記録。カメラ周回と既存表情キーの10秒動画はReleaseへ添付し、参考ダンスFBX・モデル本体を配布しない。

## 2026-10-15 一般公開
- ユーザー「こちら公開してください」により、このSkillsリポジトリを一般公開する。公開版1.0.3でREADMEとmanifestの状態を合わせる。従来の商用利用可・出典保持条件を維持し、モデルや参考FBXを新たに含めない。
- 1.0.3時点のLidaAngelToonは別管理で非公開。一般利用者にはアクセス権が必要と案内した。公開した範囲と、実際に匿名で確認できた取得物を制作側へ記録する。

## 2026-10-15 シェーダー公開と取得先

- ユーザーの明示指示によりLidaAngelToonも一般公開する。Skills 1.2.1では公開Release v0.1.0とaddon ZIPの直接取得先へ更新し、Skillsの任意取得という位置づけを維持する。
- Skills 1.2.1時点の配布シェーダー0.1.0の確認済み範囲はBlender 5.2.1 LTS／EEVEEで、当時のReleaseにUnity／UE実装は含まれなかった。後続0.2.0では既存Unity/UE実装を統合した。VRM自動変換の実装は含まれない。原始図形→モデルのコピーで確認する。
- 公開状態・Release資産の匿名取得は制作側で確認する。本文と取得先の変更をコードやモデルの更新として扱わず、ファイル別ライセンスを維持する。

## 2026-10-15 資料画像の来歴表示

- ユーザー指示により、配布図版16組のSVG/PNGと実モデル紹介PNG2枚へ、余白の出典帯にLida名と配布元URLを表示。本文・モデル・矢印を遮らず、資料だけが共有されても来歴をたどれる形にする。新規・更新図もこの表示を維持する。
- SVGの元要素を保持してPNGを再描画。実PNGは元画像の画素領域を変えず台紙の下へ帯を足す。動画の再エンコードとPNGの画素保持は区別する。これは表示の整備であり、新しい利用制限やモデルデザインの利用許可ではない。

## 2026-10-15 翼の全体配置と名称

- 1.2.3で `references/wing-feather-terms.md` と自作図を追加。工程・取付の既存図とは分け、初列/次列/三列風切、初列雨覆、大中小雨覆、小翼羽、肩羽、下面の下雨覆/腋羽を番号で対応させる。
- 鳥の一般構造と創作の採用原画を区別する。三列を三段目や三枚固定、小翼羽を短羽全般、大中小を単なるサイズ分類にしない。初列側にも大中小の群があり、本文と図の略称を合わせる。根元の被覆関係と、列内の左右の重なりは分ける。
- 外部図を転載・模写せず、一次資料で名称と区域を確認して自作する。全群を創作翼へ機械的に追加せず、保持する輪郭・採用群・省略群を原画へ対応させる。図は余白へLida名とURLを表示する。

## 2026-10-15 手の一連の工程と横断補足
- 1.3.0で手を素材・初期形状・網目と骨・指間/親指の重み・爪・短縮・指定動作・保存/出力まで専用章へ集約。構造と変形診断の自作図2組を追加し、実メッシュの成功画像と区別する。初回依頼へ保持部・表面沿いの変形・境界曲率・点間隔の診断を含める。
- 空間的に近い点と皮膚表面の経路を混同しない。重みの遷移を広げるだけ、頂点や輪を増やすだけを万能な解決にしない。指骨の役割、面の流れ、爪の追従を同じ版で比較する。
- 制作記録の本文・STATUSにある作成時の候補状態だけで採否を決めず、後続の明示的な選択・統合記録も照合する。局所採用と全身・出力先の確認は分ける。
- 骨の保存基準/表示姿勢/角度0、肩脇の多方向比較、UV・画像・材質の対応と保存読込を既存章へ補足。文章を広く複製せず工程索引から該当節へ進める。

## 2026-10-15 髪を作る専用工程
- 1.4.0で髪の資料・粗い全体形・毛束構造・根元/毛先・頭皮下地・基本追従・質感・揺れ・保存/出力を専用章へ集約し、構造の自作図1組を追加。AO/UV/二次揺れの詳細は既存章へリンクする。
- 中心線の形状ガイドと実エッジ/骨、髪カードと厚みの房、意図した房同士の重なりと同じ房の不意な切断を区別する。全モデルへ閉断面や毛先の数を強制しない。
- 2Dの髪だけ資料から顔を除去した後も根元の連続を確認する。資料の了承と受領FBXの生成上の関係は別の事実。生え際の肌色修正と頭皮下地の立体補完、固定下地と首肌の追従も分けて診断する。
- 動作干渉は問題房/鎖と相手を特定し、必要な鎖の当たり判定だけ調整。全コライダーの拡大や揺れ全停止を一般解にしない。末端点の衝突設定と毛束全メッシュの安全を混同しない。

## 2026-10-17 使用先の外観差と素材の診断
- 1.4.1で色管理・取り込み→基本色/影→艶→輪郭/透過→保存読込を専用章へ集約。工程索引から参照し、共通素材の修正と使用先固有の仕様差を混同しない。
- 口内は実際に見える面と基本色を単独確認してから光やAOへ進む。羽の縁は基本色だけでなく影色と対応アルファも確認し、方式未確認の割り戻しや二重補正を避ける。
- キャラクターの基準画像/材質とショット固有の撮影/色補正を分ける運用は推奨案。映画での実証、エンジン間完全一致、未検証アプリでの成功へ広げない。既存20組の図解・コード・利用条件を保持する。
## 2026-10-17 装飾の材質判断とメッシュ修復・補完
- 1.5.0ではaccessory-materials.mdとmesh-repair-completion.mdに専用判断・施工・AI依頼を集約し、M1〜M3/K1〜K4/P1〜P3の自作模式図3組を対応させる。図は修復結果や万能な面配置ではない。
- 材質共有は名前でなく実データ参照を確認。元画像・UV・形を保持して原因の設定だけを比較し、PBRとトゥーンの入力、MatCap画像変更と係数変更を分ける。
- 修復前に意図した開口・健全境界・変更領域を確定し、面張り/接続/再構築と必要属性を一組にする。新規頂点のキーは影響範囲に必要な変位、対象外は0を確認し、全キーへ無理に変位を与えない。網目変更時は全体ハッシュ差を失敗にせず、保持領域と意味上の対応で検証する。
## 2026-10-19 制作計画とウインク

- 全体制作の初回にproduction-plan.mdで工程順・依存・各終了条件を作り、メッシュ・貫通・材質・手指の動き・眼球の5項目を診断計画へ入れる。必要な補正は同じ依頼範囲で実行と確認まで進め、個別の再指示待ちにしない。部位依頼の範囲を広げず、未検査と不要/済を区別する。
- 材質は対象面・実材質・共有先・画像UV・接続と値を記録し、変更可能範囲を既存指示と照合する。対象の症状と保持条件の範囲で調整できれば再承認不要。未確定の意匠・配色・画像・共有先を変える具体案だけ確認し、独立作業は続ける。
- ウインクは通常blinkを保持し、同一基準顔の目だけの差分を左右へ分ける。相補マスクの和1は差分復元の条件であり、途中・組合せの接触安全ではない。顔と影等の依存・入力割当を照合し、詳細検査で残る微小隙間や浮きまで消えたと書かない。
- W1〜W3の図は自作模式図。左右は本人基準で示し、反対眼・口・眉の固定と通常瞬きの役割を分ける。制作モデルや採否をSkills更新により変更しない。
- 2026-10-19追加：最初の頭部三面図で髪あり/髪なしを両方用意し、同一顔/頭蓋/縮尺で生成後に良い部分を合成する。髪なしの顔・頭部を基準に髪あり由来の髪と根元を選び、二重の頭部や内部面を整理する。髪単体入力の顔なし条件と混同しない。これはユーザーの制作知見として記録し、改善率や全例の成功を断定しない。
- 2026-10-19追加：表情を使う制作は、表情シート/単体画像の不足判定・生成・比較を初回計画へ入れる。通常顔の版と基準セル、必要な口型/目/感情、本人左右、変更/固定部、画像/個別3D/キーの対応を残す。一覧シートは比較用で、一つの頭部の3D生成へ丸ごと渡さない。良い資料/キーの再生成や全表情の背面図を必須化せず、材料了承と3D・途中・使用先の合格を区別する。

- 2026-10-19追加：新規の動く人型は、通常形と関節の網目→150MB以内のアップロード用FBX→TripoでVRM 1.0骨格のオートリグ→保持照合→骨・ウェイト・依存部品の調整を計画する。コピーで容量対策し、受領メッシュの対応が変わったら旧頂点番号を流用しない。骨格規約と完成VRMは別。良い既存リグは再生成不要。この追加を過去モデルの制作実績へ置き換えない。

## 2026-10-19 機械検査と見た目・動作の分離
- rig-auditは明示したリグ・人型対応表・対象メッシュの機械項目を検査する。人型名から左右を推測せず、必須/任意骨と補助骨、正規化と造形を区別する。FBX条件CLIは実容量・識別ヘッダを確認し、完全なFBX構文や受付成功を保証しない。
- CLIの0を完成・美術合格にしない。原画/同条件画像、必要な単独と途中/最大/戻り・複合動作、保存と使用先を別に記録する。数値改善でも見た目が悪化した案は採用しない。実画像は同じ保存モデルに対応させ、生成画像を証拠に置き換えない。局所や静止の依頼範囲は維持する。詳細はreferences/mechanical-visual-review.mdとmodel-tools.md。

## 2026-10-20 英語対応と別制作の知見
- 1.7.0はREADME、SKILL.en、全参照章と導入・更新・利用条件の英語説明を対応させる。英語利用では必要なEN章を読み、二言語の全章を同時ロードしない。図は共用し、英語本文で番号・色・方向・固定部を説明する。
- 原文と訳の対応および原文SHAをmanifestへ登録する。原文更新時は意味と条件を再読してからSHAを更新し、古い訳を隠すためにhashだけ更新しない。構造検査は意味の正確さを証明しない。
- 最新確認ではリダ以外の新規制作にSkills改善メモがある。別制作の手指、口内、FBX画像と材質枠、リグ受領、長袖の診断はgeneration-feedback.mdへ集約し、既存工程から参照する。別キャラの画像・デザイン・絶対パスを持ち込まない。
- ポールの平滑化、指断面、親指の軸、舌の立体、下歯の退避、袖の現在親フレームを原因別に扱う。元作例の角度・比率・色・座標系・周波数を既定値にしない。局所成功・有限検査・ユーザー採用・使用先を分ける。
- 著作権記号とLida名・配布元を保持し、条件の英訳で制限を追加しない。出典ヘルパーの--language enは新規ブロックの言語選択であり、既存出典の翻訳やモデル成果物へのクレジット追加ではない。

## 2026-10-21 参照モデルはSkillsの構成要素
- ユーザー訂正「Skillsの一部ですこれ」に従い、参照モデルを公式Skills一式ZIPとportableスキル内へ物理同梱する。通常取得を完成Release ZIPへ統一し、別取得を標準にしない。旧い任意別添という判断は上書きする。
- モデル本体の再配布・改変販売は禁止。モデルを含む一式ZIPの利用者再配布は不可。モデルを除いた文書・コードの各許諾とGPLは保持する。モデル条件と取得構成は別の論点である。
- GitHub保守用ソースには固定取得元/SHAを記録し、明示したfetchで復元して完成ZIPに必須収録する。完成ZIPとCode/Source ZIPを導入案内で混同しない。固定モデル以外の大容量/VRM/FBX混入を許可しない。

## 2026-10-27 最新制作の汎用的な補足
- 別の制作で起きた口線と開口境界、口角の表裏、手の再寸法化と指骨接続/節ごとの重み、閉瞼の描線、UV・材質・FBX保存読み戻し、脚の過補正、揺れ/表情バインドを日英の専用章へ集約した。指定された対象の情報・画像は収録しない。
- 口の模式図は描画線と開口境界を区別し、口角の支点と表裏を示す。実修復結果ではなく、原画やモデルに合わせて線の位置を決める。
- 作例固有の数値や見た目を標準値にせず、内部候補と有限検査、ユーザー採用、使用先検証を分ける。通常導入の完成ZIPは既存の参照モデル・専用条件を同梱し続ける。