seohead project newは、1つのサイト用のローカルフォルダを作ります。中身は、project.json、scansフォルダ、reportsフォルダ、人が読むログのlog.mdです。保存したビュー、追記専用のイベントジャーナル、チェックリストは、作業が進むにつれて増えます。ただのフォルダなので、アーカイブして別のマシンに復元できます。
ワークフローの実行は、登録済みのステップごとにチェックポイントを保存します。エージェントが止まっても、workflow-statusで次のステップが正確に分かり、workflow-resumeは中断したステップだけを開き直します。書き込みは必ず現在のリビジョンを指定し、競合すると失敗します。そのため、2つのエージェントが気付かないまま互いを上書きすることはありません。
完了したタスクを、サイトのエラーが修正された証拠とは見なしません。チェックリストが追跡するのは、合意した作業です。検出結果を追跡するのは修正台帳で、ケースを解決済みにするのは、厳密な再チェックの結果か、その後に測定した観測値があるときだけです。途中までのスキャンで検出結果が消えても、修正済みとは数えません。
seohead project new --directory ./shop --target https://example.com/ を実行すると、サイト、スキャン、レポート、ログを含むローカルフォルダができます。フォルダごと移動できます。
チェックリストの項目には、残り、ブロック中、古い、レビュー待ちのどれかが表示されます。完了したタスクはタスクとして記録され、サイトのエラーが修正された証拠としては扱いません。
ワークフローの実行は、ステップを順に完了させます。別のエージェントは、workflow-statusで次のステップを把握し、workflow-resumeで中断したステップを開き直します。
| チェック項目 | 意味 | 重要度 | 根拠 |
|---|---|---|---|
BROKEN_PAGE_4XX | ページが4xxのレスポンスを返す。再チェックで修正が確認されるまで、プロジェクトでは未解決の項目として残る | Critical | 保存済みスキャンのステータスコードとURL |
REDIRECT_LOOP | リダイレクトチェーンが、有効な転送先に到達しない | Critical | 保存済みスキャンのリダイレクトチェーン |
REDIRECT_CHAIN | 最終URLに着くまでに2ホップ以上のリダイレクトがある | Important | 保存済みスキャンのリダイレクトチェーン |
TITLE_MISSING | title要素がない | Critical | 保存済みスキャンのページ行 |
CANONICAL_MISSING | インデックス可能なページに正規URLがない | Important | 保存済みスキャンのページ行 |
seohead project new --directory ./shop --target https://example.com/先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。