ccf-paper-to-exemplar

Paper-to-Exemplar

Family File Contract

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

Collaboration Contract

専門担当者が作業を開始する前に、まず ccf-humanization を読み、適用してから、ccf-common を読み、適用します。引き継ぎのたびに、適用可能な有効なルールを再利用するか、欠落または変更があったルールを再確認します。文章がない場合でも、両方の事前確認が必要です。詳細な編集、実験、メンテナンスの各モードは、関連する場合にのみ実行します。

必要な専門担当者の成果を、1人のオーナーのもとに統合します。有効な前提条件を再利用し、影響を受ける結果を検証します。重複した報告を避けるため、協力ルートに従います。

Scope And Shared Controls

提供された論文PDFから再利用可能な文章パターンを抽出し、出典の帰属と科学的な意味を保持します。このスキルが担当するのは模範カードです。原稿の作成は ccf-paper-writer、視覚表現の再構成は ccf-visual-composer、科学的レビューは ccf-paper-reviewer が担当します。

../ccf-common/references/handoff-modes.md、../ccf-common/references/task-modes.md、../ccf-common/references/artifact-contracts.md に従います。書き込みの前に、既存のカード／ライブラリのパスとキャッシュのパスを確認します。新規ファイルを作成しないよう求められた場合は、指定された既存のカードを編集するか、分析結果を会話内で返します。変換しただけでは、ライブラリ全体や既定値を変更する権限はありません。

ワークフロー

1. PDF のパス、ソースのバージョン、希望する執筆パターン、任意の投稿先、承認済みの保存先を特定します。同じソースと依頼範囲に合致する完成済みカードと抽出結果があれば再利用します。ソースの新しいバージョンがある場合は、影響を受ける分析を確認します。
2. 抽出が必要な場合は、選択した作業用キャッシュを指す --output-dir、--full-text、--full-text-dir を明示して scripts/convert.py を実行します。新規プロジェクトでは、共有のデフォルトパスは ccfa-workfiles/exemplars/<source-id>/ で、抽出結果は cache/ に保存します。既存のパスが確立されている場合は維持します。コンバーターは既存のカードを保持し、不足しているスケルトンのみを作成します。--full-text-dir は任意です。省略すると、従来の出力レイアウトが維持されます。抽出には Python と pymupdf が必要ですが、有効な既存カードの再利用には必要ありません。
3. 抽出の成功とページマーカーを確認します。関連する全文ソースをまとまりのあるセクションに分けて分析します。ローカルカードを更新する場合は、検索と範囲指定による確認を活用します。数式、図、読み取り順が解釈に影響する場合は、PDF の実際のページを確認します。全文論文の参考例を要約のみの分析で代用したり、抽出結果が空であるものを完了とみなしたりしないでください。
4. ソースのストーリー、要旨・序論・方法・エビデンスの展開、引用パターン、再利用可能な手法を把握します。必ずしも限界を結びとする必要はありません。助言に防御的な癖、人為的なラベル付け、数式の羅列、裏付けのない誇張、機械的な文章が含まれないよう、../ccf-paper-writer/references/prose-quality-guardrails.md を参照します。
5. scripts/convert.py が生成したセクション見出しと既存カードに沿って、既存のカードをその場で記入または改訂します。見出しは Story Pattern、Abstract Moves、Introduction Moves、Method Moves、Evidence Moves、Citation Patterns、Reusable Techniques、Do-Not-Copy Boundary です。確認済みの場合はタイトル、投稿先・年、ソースの識別情報・バージョン、関連するページ・セクションの参照箇所を記録します。言語への適応が求められている場合は、関連する句読点、文のリズム、接続表現の慣例を、参照箇所と用途を添えて Reusable Techniques に記載します。新しいプロファイルファイルやコーパスの割り当て量は不要です。ソースに重要な例がある場合に限り、Excluded Anti-Patterns を追加します。文章作成の手法と、ソース固有の主張や特徴的な表現は分けて記載します。
6. ライブラリへの登録が求められている場合は、../ccf-paper-writer/references/exemplars/cards/ またはユーザーが既に使用しているライブラリを使い、重複項目を追加しないよう ../ccf-paper-writer/references/exemplars/index.md を更新します。無関係なカードは保持します。同じファイル名であることだけでは、同じソースだと判断できません。生の抽出結果は作業用キャッシュに保存し、再利用可能なカードライブラリには含めません。
7. デフォルトの選択を求められた場合に限り、../ccf-paper-writer/references/custom-format/default-user-format.md を更新します。投稿先のみの依頼では、別の PDF を抽出する代わりに、インデックスから既存の関連カードを選択できます。投稿先の分類が不明確な場合に限り、../ccf-paper-writer/references/venue-guides/index.md を読み込みます。
8. 完成したカードに [ANALYZE] または [MANUAL] のプレースホルダーが残っていないこと、ソースの参照箇所が正確であること、出力先とキャッシュのパスが整理されていることを確認します。カードの正規パスと有用な執筆パターンを返します。登録やデフォルトに実際の変更を加えた場合に限り、その変更を報告します。PDF の抽出全文をそのまま出力したり、汎用的な次のアクション一覧を追加したりしないでください。

Writer Handoff

選択したカードのパス、ソースの識別情報、関連する執筆手法を引き継ぎます。スタイル参照が必要かどうかは、依頼内容に応じて執筆者が判断します。段落の編集であっても、デフォルトや投稿先ごとのカード一式を自動的に読み込むわけではありません。原稿全体の執筆や明示的なスタイル適応では、../ccf-paper-writer/references/exemplars/index.md から選び、該当するセクションやカードのみを読み込みます。既存のユーザーデフォルトは保持し、すべての執筆依頼で必ず読むものとして扱わないでください。