openpress-apply-comments

open-press コメントの適用

これは、保留中の @openpress-comment マーカーをソースの編集に反映するためのワークフロースキルです。要求されたソース変更が行われ、マーカーが削除された場合にのみ、コメントは解決済みとなります。

エージェントが提案、更新、レビュー済みプレビューの適用、または直接編集のどれを行うべきかは、openpress-collaborate が管理します。マーカーの扱いにはこのスキルを使用してください。ユーザーから .openpress/review/current.json の適用を求められた場合は、コメントを個別の直接編集バッチとして解釈せず、openpress-collaborate に戻ってください。

責任範囲

• 保留中の @openpress-comment マーカーを一覧表示します。
• デコードされたコメントのメモ、ヒント、ソースパス、周辺のソースを読み取ります。
• 要求された編集を小規模なソース変更として適用します。
• 編集が完了したらマーカーを削除します。
• 曖昧なコメントや失敗したコメントはそのまま残します。
• 完了を報告する前に検証します。

境界

• 正規のソース／生成先の対応表が不明な場合は、openpress を使用します。
• 生成された出力ではなく、ソースを編集します。
• 原則として、マーカーを含むソースファイルを編集します。
• ドメイン固有の作業は、担当するスキルに任せます。
  • ページ本文、階層、キャプション、主張、トーン、ナラティブ、ページテーマ、ページコンポーネントについては、openpress-create-pages を使用します。
  • デッキのナラティブ、スライドの情報密度、スライドの直接ソース、アクティブなテーマトークン、コアの Object API 構成、Tailwind のセマンティックスタイリング、再利用可能な UI プリミティブについては、openpress-create-slide を使用します。
  • 外部の図作成ツール、ビジュアルツール、執筆支援ツールについては、openpress-plugins を使用します。
• 1 つのコメントを解決する際に、無関係なセクションを書き換えないでください。

ワークフロー

1. コメントを見つけます。

   rg "@openpress-comment" press -n
   

   デコード済みのメモが必要で、フレームワークのヘルパーがある場合は、次を使用します。

   node --input-type=module -e 'import { listCommentMarkers } from "./packages/core/engine/react/comment-marker.mjs"; console.log(JSON.stringify(await listCommentMarkers({ root: process.cwd() }), null, 2));'
   

2. 要求された範囲を選びます。

   • ユーザーが 1 つのコメントを指定した場合は、そのコメントだけを解決します。
   • ユーザーが ID を指定せずにコメントの適用を依頼した場合は、ソース内の順序で保留中のコメントを処理します。
   • コメントは 1 つずつ処理します。無関係な書き換えを 1 つのマーカーの下にまとめないでください。

3. 対象を確認します。

   • マーカーを含むソースファイルを読み取ります。
   • 編集前に周辺の行を確認します。
   • マーカーのヒントや、存在する場合はレンダリング済みオブジェクトのメタデータを参考にしますが、ソースと照合してください。

4. 編集を適用します。

   • コメントを満たす最小限のソース変更を行います。
   • ローカルのスタイル、コンポーネント API、MDX の構造を維持します。
   • 要求が曖昧な場合は、明確化を求め、マーカーをそのまま残します。

5. 解決済みのマーカーを削除します。

   • ソースの編集が完了してから @openpress-comment マーカーを削除します。
   • 読み取っただけでマーカーを消さないでください。
   • ユーザーが明示的に求めた場合に限り、編集を適用せずにマーカーを削除します。

6. 検証します。

   npm run build
   

   build は構造を検証し、出力全体をレンダリングします。内側の手順を素早く反復する場合は、次を実行します。

   node engine/cli.mjs validate .   # structural checks only, no render
   node engine/cli.mjs export .     # rewrite document.json only, no Vite bundle
   

完了報告

次の内容を報告します。

• 解決したコメント ID
• 変更したファイル
• 曖昧または失敗したために残っているコメント
• 実行した検証コマンドと、その結果

よくある間違い

• public/openpress/、dist-react/、.deploy/、.openpress/ は編集しないでください。.openpress/review/current.json は、別の openpress-collaborate ワークフローのみが管理します。
• 未解決のコメントを削除しないでください。
• コメントで明示的に求められていない限り、広範囲のセクションを書き換えないでください。
• エクスポートが必要な場合は、ソースがエクスポートされるまでブラウザー上で変更されたと報告しないでください。