complete-example

complete-example Skill

• 既存の LaTeX プロジェクトに「サンプル内容」を追加するためのものであり、実際の研究成果を書くものではありません。
• AI は意味の理解、リソースの関連付け、叙述の生成を担当し、ハードコードされた処理はファイルのスキャン、構造の保護、形式の検証、バックアップを担当します。
• 「完全なサンプルのように生成する」ことを重視しつつ、テンプレートの骨組みとシステムファイルを破損しないようにします。

入力

必須：

• project：プロジェクト名またはパス。

一般的な任意パラメーター：

• content_density：minimal / moderate / comprehensive
• output_mode：preview / apply / report
• target_files：デフォルトでは extraTex/*.tex を自動検出
• narrative_hint：サンプルの叙述の方向性を指定しますが、あくまで「サンプルシナリオ」の範囲にとどまります。

デフォルト値と詳細は config.yaml から一元的に読み取ります。

適用対象と対象外

• 適用対象：NSFC / thesis / paper などのプロジェクトに、サンプルの章、サンプルの表、サンプルの図表を含む叙述を追加する必要がある場合。
• 対象外：実際の研究論文の執筆、テンプレートの修復、構造の再構成、システム設定ファイルの変更。

ワークフロー

入力

ユーザーの依頼と設定ファイルに基づいて必要な入力を指定します。不足している情報は明示して列挙し、その入力に依存する手順を停止します。

実行手順

• ユーザー環境で、この Skill の設計上の欠陥が原因のバグが発生した場合は、bensz-collect-bugs を使用して規定に従い ~/.bensz-skills/bugs/ に記録することを優先し、ユーザーのローカル環境にインストール済みの Claude Code / Codex の Skill ソースコードを直接変更することは厳禁です。
• 回避策によって AI がユーザーのタスクを続行できる場合は、まずバグを記録してから、現在のタスクを続行します。
• ユーザーが「report bensz skills bugs」などの公開報告を明確に要求した場合は、ローカルの gh と bensz-collect-bugs を呼び出し、新規のバグのみを huangwb8/bensz-bugs にアップロードします。バグリポジトリ全体を pull / clone しないでください。

1. プロジェクト内の figures、code、references などのリソースをスキャンします。
2. AI が章のテーマ、重要な概念、語調、文脈を分析します。
3. AI がリソースと章との関連性を推論し、内容の種類の組み合わせを決定します。
4. narrative_hint を参考に、まとまりのあるサンプルの叙述を生成します。
5. ハードコードされたテンプレートで囲み、適切な LaTeX にします。
6. 生成内容を自己検証し、最適化します。
7. 形式と構造を検証し、必要に応じて品質レポートを生成します。

• AI：意味の分析、リソースの選択、テキストの生成、自己最適化。
• ハードコード：ファイルのスキャン、Top-K の選択、LaTeX のラッピング、形式の保護、バックアップ、ログ、構造の検証。

config.yaml の以下の項目に特に注意します。

• parameters.*
• run_management.*
• scan.*
• generation.*
• generation.section_hierarchy.*
• generation.templates.*

出力

• すべての実行生成物を {project_path}/.complete_example/<run_id>/ に書き込みます。
• 典型的な構成：
  • backups/
  • logs/
  • analysis/
  • output/
  • metadata.json
• output_mode=apply の場合に限りプロジェクトに書き戻します。それ以外のモードではプレビューまたはレポートのみを提供します。

出力管理

この Skill の新しいタスクの中間ファイルは、すべて ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/ に書き込みます。同じタスクでは1つのタスクルートディレクトリを再利用し、複数の Skill が連携する場合にのみ shared/ を作成します。正式な納品物はこのディレクトリに書き込まず、過去の隠しディレクトリは明示的な互換読み込み、移行、またはクリーンアップの場合に限り使用できます。

検証

完了後、Skill に既存の静的チェック、スクリプト検証、または人によるレビューを実行し、合格基準を記録します。

失敗時の対応と復旧

エラーの証拠と完了済みの生成物を保持し、入力、環境、または外部依存関係が復旧した後に限り、直近の失敗手順から再試行します。

制約

• システムファイル main.tex、extraTex/@config.tex、@config.tex の変更は禁止です。
• ブラックリスト対象ファイルにはアクセス制御とハッシュ検証を適用します。不正な変更の試みが検出された場合は、必ず拒否します。
• main.tex では \section / \subsection のみを許可します。入力ファイルである extraTex/*.tex では \subsubsection / \subsubsubsection のみを許可します。
• 生成内容は「サンプル」としての性質を保ち、実際の実験や実際のデータの出典を装ってはなりません。

共通の厳守事項

• タスクでファイルへの書き込みが必要な場合は、一意の ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/ をルートディレクトリとして使用します。共有資料は shared/ に、Skill 固有の資料はその Skill の input/、output/、log/ に格納します。
• 正式な納品物、ソースコード、正式な計画はプロジェクトの規定に従って保存し、タスク作業領域には書き込みません。許可なく上書き、削除、移行、またはリモートへの書き込みを行ってはなりません。
• プロジェクトの保守変更では BAC の利用可否を確認し、要件、AI の生成物、ツールの結果、ファイルの変更、検証の概要を記録します。BAC はプロセスの監査のみを行い、帰属、責任、コンプライアンスの判断に代わるものではありません。
• API Key、アクセス トークン、パスワード、Cookie、環境ファイル／認証情報ファイル、非公開 Prompt、個人情報、ローカルユーザー名、ホスト名、または不要な大容量の生データを記録してはなりません。
• ファイルパスは正規化し、許可されたプロジェクトの範囲内に制限します。外部 URL、サブプロセス、ネットワークアクセスには最小権限の原則を適用し、パストラバーサル、SSRF、コマンドインジェクションを防止します。
• Skill のバージョンは、その Skill 自身の config.yaml:skill_info.version にのみ記録します。公開 API、プロトコル、ディレクトリ、または設定の変更にあわせて、ドキュメントと CHANGELOG.md も更新します。
• bensz-collect-bugs に報告するのは、Skill または Bensz のインフラストラクチャ自体の設計上の欠陥に限ります。まず機密情報を除去して ~/.bensz-skills/bugs/ に記録し、現在のタスクは中断しません。公開報告はユーザーが明確に要求した場合に限り行い、ユーザーがインストール済みの Skill のソースコードを直接変更することは禁止します。

Skill 固有の制約

この Skill の description と上記のワークフローで宣言された範囲を超えてはなりません。未検証の情報を確定的な結論であるかのように示してはなりません。