specsfy-progress

全体の進捗を報告する

必須の準備

このスキルを実行する前に、プロジェクトのルートで必ず $specsfy-setup を読み込んでください。自動ハンドオフの場合は、このステップの前にもう一度読み込んでください。 会話で確認済みのルートを再利用し、セットアップで未解決事項が示された場合は先に進まないでください。

対話モード

対話モード：質問なし。 このスキルでは質問しないでください。確認できた見通しと、該当する次のハンドオフを提示してください。

状態は specs/<estado>/*/spec.md からのみ読み取ってください。レポートは真実の情報源を投影したものであり、二つ目の状態情報源ではありません。

会話をオーケストレーションする

このステップが完了したとき、または別のステップの作業を検出したときは、 Pendência detectada: <descrição> — ação: resolvendo nesta etapa と通知し、その作業が自身の対象範囲に属する場合は解決してください。責任の切り替えが発生する場合は、 Transição automática: $specsfy-progress → $<destino> — motivo: <motivo> — resultado esperado: <resultado> と通知し、確認を求めたりコマンドを繰り返したりせず、直ちに移行先のスキルを読み込んでください。同じ会話を続けてください。必要な修正を行った後は、 Retomada automática: $<destino> → $specsfy-progress — pendência resolvida: <resultado> と通知し、直ちに再開してください。ハンドオフのたびに状態を再評価し、ループを避けてください。ハンドオフの確認を求めないでください。機微な操作には引き続き個別の承認が必要です。

実行する

リポジトリのルートで：

node .agents/skills/specsfy-progress/scripts/progress.mjs .

他のツールとの連携用：

node .agents/skills/specsfy-progress/scripts/progress.mjs . --json

単一の仕様の場合：

node .agents/skills/specsfy-progress/scripts/progress.mjs . --slug <slug>

仕様のコンテキストコストを確認する場合：

node .agents/skills/specsfy-progress/scripts/analyze_context.mjs \
  specs/<estado>/<NNNN>-<slug>/spec.md --json

進捗とともにドキュメントの未解決事項を投影する場合：

node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
  --project . --check

node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs \
  --project . --check

PENDING は納品のブロッカーとして扱い、モニターが示すハンドオフを通知してください。補助スキルがドキュメントを更新するか、影響のない評価が記録されて確認された後、このスキルを再開してください。 2番目のコマンドでドキュメントの欠落または古さが示された場合は、$specsfy-documentator へのハンドオフを通知し、docs/ を再構築してから投影を再開してください。

--usage-json を指定しない場合、結果には常に estimated とラベル付けし、ヒューリスティックを記録します。明示的に提供された指標は measured とします。推定値を実際の使用量として提示してはいけません。

解釈する

1. 仕様、ゲート、タスク、チェックリスト項目の分母を報告してください。
2. Status から導出した現在のアクションと、次に担当するスキルを示してください。
3. 完了した仕様、進行中の作業、実際のブロッカーを区別してください。
4. 準備が整った次の TNNN/ITEM のペアがあれば示してください。
5. Failed のゲート、チェックリストの不整合、または準備が整った経路のない依存関係はブロッカーとして扱ってください。In Progress のゲートだけであれば失敗ではありません。
6. monitor_context.mjs が必須として示すドキュメントは、すべてのチェックボックスにチェックが入っていてもブロッカーとして扱ってください。
7. $specsfy-documentator に従って docs/ が存在しない、または古くなっている場合は、納品のブロッカーとして扱ってください。
8. 既存の仕様で動作または計画の変更が必要な場合は、未解決事項を通知し、$specsfy-update-spec を自動的に読み込んでください。更新によって無効になったアクションを一通り通過した後、投影を再開してください。
9. 仕様が存在しない場合は、コード 2 を維持してください。specs/inbox/ のキャプチャと specs/backlog/ の項目は、規範的な進捗として数えません。依頼で既存のキャプチャを進めることも求められている場合は、未解決事項を通知して $specsfy-02-backlog を読み込んでください。意図と定義がすでに十分にそろっている場合は、$specsfy-03-specify を読み込んでください。

情報源を維持する

• 確認中に仕様、チェックボックス、テスト、コードを編集しないでください。
• research/ 内の spec.md は数えないでください。対象は specs/<estado>/*/spec.md に厳密に限定されます。
• コミット、ファイル、チャットの記憶から進捗を捏造しないでください。
• 状態を更新するには、同じ会話内で担当スキルを通知して自動的に読み込んでください。更新後は進捗を自動的に再開してください。

報告

まず全体の概要を提示し、次に注意が必要な仕様、ブロッカー、次の作業を提示します。実行可能なステップがある場合は、告知してから自動的に移行を実行します。ユーザーが自動化または構造化データを求めた場合は、フィールド名を読み替えずに JSON 出力を使用します。

必要に応じた専門家

次のタスクに向けたコンテキストを提案する場合に限り、references/specialists.md を読みます。担当する基本スキルまたはインストール済みの専門家は自動的に読み込みます。インストールには個別の許可が必要です。