ccf-project-scaffolder

CCF プロジェクトスキャフォルダー

ファミリーファイルの契約

ファイルを扱う前に、標準パスと、タスク／成果物ごとに一つの作業ディレクトリを再利用します。既定ではプロジェクトルートの ccfa-workfiles/<purpose>/<artifact-id>/ を使用します。既存の内容をその場で更新し、入力を保持して、UTF-8 を使用し、中国語テキストが含まれていないか確認します。命名、所有権、タスクで作成したファイルのクリーンアップには、artifact-contracts.md を適用します。引き継ぎ時もこれらのパスを引き継ぎます。

コラボレーションの契約

専門家が作業を始める前に、まず ccf-humanization、次に ccf-common を読み、適用します。引き継ぎのたびに、該当する有効なルールを再利用するか、不足または変更されたルールを再確認します。文章がない場合も、両方の事前確認が必要です。詳細な編集、実験、メンテナンスの各モードは、該当する場合にのみ実行します。

必要な専門家の作業を一つの担当者のもとに統合し、有効な前提条件を再利用して、影響を受ける結果を確認します。重複した報告を避けるため、協力ルートに従います。

呼び出し制御

CCFA の引き継ぎモード：PARTIAL（推奨）。 metadata.ccf_skill_controls.handoff_question_mode、../ccf-common/references/handoff-modes.md、../ccf-common/references/task-modes.md に従います。スキャフォールドの依頼は、必要なローカル構成の作成を許可します。ドライランまたは新規ファイルを作成しない依頼の場合は、それに応じて変更を制限します。

基本ルール

研究内容を捏造せず、依頼されたプロジェクト構成、テンプレート、状態を作成します。既存のユーザーファイルを保持し、確立済みのプロジェクトを置き換えるのではなく、互換性のある不足部分を補います。

ワークフロー

1. 会話とファイルシステムから、プロジェクトの場所、投稿先、依頼されたフォルダー、既存の成果物を特定します。一般的なディレクトリ名は推定し、重要な場所や上書きに関する未解決の選択肢がある場合にのみ質問します。
2. ../ccf-paper-writer/references/venue-guides/index.md から適切なテンプレートを選びます。テンプレートと、それを支えるスタイル／アセットが利用可能であることを確認します。依頼があれば提供されたテンプレートを使用し、利用できない依存関係は、不完全なテンプレートをコピーするのではなく、具体的に示します。
3. ../ccf-common/references/artifact-contracts.md を参照して、最終成果物と作業ルートを特定します。必要なディレクトリとテンプレートのみを作成し、source/assets/cache/build サブディレクトリは必要に応じて作成します。既存のレイアウトを保持します。スキャフォールドの更新を理由に、ユーザーファイルを移動したり、原稿、参考文献一覧、設定ファイルを上書きしたりしないでください。
4. 初期化が依頼されており、ccfa.yaml が存在しない場合は、assets/ccfa.yaml をコピーし、../ccf-common/references/ccfa-yaml-contract.md で必須とされるフィールドを保持して、提供されたプロジェクトメタデータのみを入力します。既存の状態は読み取り、依頼された範囲内でのみ更新します。不明な研究フィールドは、明示的なプレースホルダーのままにします。
5. 作成したパス、テンプレートの参照、YAML を確認します。実行可能なテンプレートが依頼され、エンジンを利用できる場合はビルドが有用です。ディレクトリのセットアップでは、研究実験や最終投稿チェックを実行しないでください。
6. 実際に作成／更新したパスと、具体的に不足している依存関係を報告します。ドライランの場合は、ファイルを書き込まず、提案するツリー構成と作業内容を返します。

適用範囲

ファイルの所有権には ../ccf-common/references/artifact-contracts.md を使用します。プロジェクトのワークフロー計画は ccf-pipeline-orchestrator、原稿の文章作成は ccf-paper-writer、最終パッケージの確認は ccf-submission-checker が担当します。タイトル、要旨、主張、実験、引用を捏造しないでください。