mcpField
H
hrt-artifact-lint

hrt-artifact-lint

github.com/hash-idテスト・品質251 回インストール4 日前に更新
リポジトリ

hrt-artifact-lint について

hrt-artifact-lintは、proposal、spec、design、taskの各成果物を含む変更ディレクトリを検査するスキルです。構造上の問題とサイズ情報を報告し、初期段階ではproposalのみを確認できます。

主な機能

  1. 01成果物の構造とサイズを検査
  2. 02proposalのみの検査に対応
  3. 03エラーと警告を報告
  4. 04行番号付きの診断を表示
  5. 05利用できない場合は手動確認に切り替え

活用シーン

  1. 01作業を進める前の成果物検証
  2. 02後続ファイルがない段階でのproposal確認
  3. 03変更文書の構造上の問題の特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hash-id/openspec-schema --skill hrt-artifact-lint

インストール後、Claude Code で/hrt-artifact-lintを入力して読み込まれたか確認します。

同梱ファイルlint.cjs

詳細

hrt-artifact-lint

同梱の lint.cjs（このファイルと同じ場所にあり、.agents/skills/hrt-artifact-lint/lint.cjs にインストールされます。依存関係はありません）を、変更ディレクトリ（proposal.md、specs/、design.md、tasks.md があるフォルダー）に対して実行します。

node .agents/skills/hrt-artifact-lint/lint.cjs <change-dir>

proposal フェーズで後続の成果物がまだ存在しない場合は、--phase=proposal を追加して実行します。これにより、proposal.md のみ（構造、サイズ、形式）をチェックし、specs、design、tasks がないことをエラーとして報告しません。

出力は LEVEL path:line message の形式で1行ずつ表示され、その後に Size facts: の行（capabilities、scenarios、task groups、proposal words。判定は含まれません）が続きます。ERROR がある場合は終了コード1、ない場合は0です。

  • ERROR：正しい修正方法が1つだけの、決定論的な構造上の欠陥です。ユーザーに確認せず、その場で直接修正し、変更内容を記録します。
  • WARN：ブロック要因ではありません。手早く対応できる場合は修正します。

lint が通過した後、呼び出し元がこれらのチェックを手作業で再実行することはありません。シナリオが本当に振る舞いを示しているか、要件が本当にテスト可能か、「該当なし」のセクションが本当に該当しないかといった、呼び出し元による判断はここでは対象外のため、引き続き確認します。

Node がない場合、または lint.cjs が見つからない場合は、その旨を伝え、手作業での確認に切り替えます。黙って省略しないでください。

コメント

Markdown 対応