入札書生成スキル — 建設業者向け入札生成システム
ステータス: 完了 (v1)
以下の「設計上の決定」に記載された項目は、オンボーディング時に顧客ごとに調整するポイントであり、開発ブロッカーではありません。
システム概要
このシステムは、建設業者の既存の入札書と新しい案件の詳細を入力として、既存テンプレートと視覚的・構造的に同一で、案件固有の内容のみが差し替えられた新しい入札書を生成します。同じレイアウト、見出し、書式、ブランディングを維持し、業者が後で再フォーマットする必要がない、そのまま送れる最終版を出力することを目的とします。
2つのレイヤー:
- スタイル抽出 (各建設業者に対して1回、サンプル入札書から実行) — その業者の表現方法(トーン、言い回し、詳細の密度)とリテラルなテンプレート(レイアウト、セクション順序、書式、ブランディング)の両方を取得します。詳細は
references/style-extraction-guide.mdを参照。 - 入札書生成 (新しい案件ごとに実行) — スタイル/テンプレートプロファイルとプロジェクトインプットから完成した入札書を生成します。詳細は
references/generation-workflow.mdを参照。
譲れない設計上の決定 (ユーザーの確認なしに逸脱しないこと)
- 出力 = 最終テンプレート、プレーンテキストではない。 建設業者のレイアウト、見出し、書式は毎回正確に再現する必要があります。入札書ごとに変更されるのは内容フィールドのみです。
- 事実を invent しない。 作業範囲、価格、材料、スケジュールは、ユーザー/業者がその特定の案件について提供したもののみを使用します。スキルはスタイルプロファイルから表現方法と構造を借用することはできますが、ギャップを埋めるためにプロジェクトの詳細を捏造することは決してありません。
- 業者の責任、オートパイロットではない。 生成されたすべての入札書は、顧客に送付される前に業者自身のレビューと修正を待つドラフトです。これはスキルが業者に代わって送信するものではありません。
references/review-checkpoint.mdを参照。 - 法的/保証文言は書き換えず、フラグを立てる。
references/legal-guardrail.mdを参照 — これはスタイルの選択ではなく、確固たるポリシーです。 - バージョニングはルール抽出ではなく、変更前/変更後リファレンスを使用する。
references/versioning-approach.mdを参照。
新しいクライアントの入札書生成機能を構築する際の手順
- 最初に
references/bid-anatomy-residential-remodeling.mdを読んでください。これは調査済みの、業界標準となる住宅リフォームの完全な入札書の骨格です(表紙、作業範囲、価格、スケジュール、支払いスケジュール、条件/法的セクションなど)。これを比較基準として使用します。業者の実際のサンプルがこれに一致する場合は確認、異なる場合は「修正すべきエラー」ではなく「プロファイルに記録すべきビジネス上の表現の選択」として扱います。 references/style-extraction-guide.mdを読み、業者の実際のサンプル入札書2~3以上に対して手順を実行し、スタイル/テンプレートプロファイルを構築します。- 保証、責任、補償、ライセンス/保証、または支払い紛争に関する文言を含む入札書を生成する前に、
references/legal-guardrail.mdを読んでください。 - 入札書ごとのインプットと生成手順については
references/generation-workflow.mdを読んでください。 - 業者が生成された少なくとも1つの入札書の修正版を送り返してきたら、
references/versioning-approach.mdを読んでください。これにより、生成機能は時間とともに改善されます。 references/review-checkpoint.mdを読んで、「レビュー待ち」マーカーがすべての出力にどのように表示されるべきかを確認してください。
提供アーキテクチャ (クライアント企業が実際にこれをどのように使用するか)
決定事項: 建設業者はClaudeと直接やり取りすることはなく、スキル/プロジェクトへのアクセス権も持ちません。スキルの指示へのアクセスは運用者(Marcos)の知的財産であり、運用者のアカウント上にのみ保持されます。
パイプライン: Googleフォーム(プライベートリンク、業者専用ツールに見える)→ Zapier → このスキルの指示を使用したClaude API呼び出し → 完成した提案書が自動的に配信される(メールまたは共有Driveフォルダ)。一度構築すれば、運用者による手動ステップは不要です。これは lead-capture-skill ですでに使用されている「フォーム → Zapier → Claude → 配信」の形状を反映しており、リード獲得の代わりに入札書生成に適用した同じパターンです。
これが継続的な収益が成り立つ理由です。クライアントは、自分たちで再構築できるツールではなく、見ることも所有することもできないパイプラインに対して支払いを行っているのです。
将来 / まだ対象外 (v2以降)
- 自動材料価格照会。 調査済みのアイデアですが、意図的に延期しています。建設業者がプレーンな材料リスト(品目 + 数量、できれば希望仕入先)を提出し、エージェントが指定された小売店/仕入先サイトから現在の価格を照会し、その価格結果が生成ステップに直接フィードされる — 手動でのスプレッドシート作成や再提出は不要。これがスコープに入ったときに対処すべき実際の注意点: 小売店サイトによって自動化の可能性は異なり、製品マッチングの精度は保証されず、価格出力はこのシステムの他のすべてと同様に業者が確認するドラフトとして扱う必要があります。コア生成機能が実際のクライアントの実際の入札書で動作し、実証されるまで構築しないでください。
設計上の決定とクライアントごとの調整
- 最小サンプル入札書数 — クライアントごとに調整。業界調査(
bid-anatomy-residential-remodeling.md)は入札書の標準的な形状を説明していますが、一人の建設業者の実際の入札書が互いにどれだけ異なるかは教えてくれません。初期想定: 2~3以上、仕事の種類が大きく異なる場合はさらに多く。クライアントの実際のサンプルからクライアントごとに確認。 - 建設業者が実際に使用するドキュメント形式 — 解決済み。最終的な顧客向け成果物は、作成ツール(Word、Excelベースの見積もり、専用提案ソフトウェア)に関係なく、圧倒的に完成したPDFです。それでも、生成ツールが編集する元のテンプレート形式はクライアントごとに確認してください。出力がPDFに収束する場合でも、編集元が異なる可能性があるためです。詳細は
bid-anatomy-residential-remodeling.mdを参照。 - 職種別適応 — 種まき済み(v2拡張)。このスキルの現在の調査(
bid-anatomy-residential-remodeling.md)は、特に住宅リフォームを対象としています。他の職種(屋根工事、配管工事など)向けのtrade-adaptation-guide.mdはv2拡張であり、lead-capture-skillと同じ適応ガイドパターンに従い、他の職種が調査またはオンボーディングされた後に作成されます。
主要原則
特定のクライアント企業に対して、スタイルとテンプレートの抽出、法的ガードレール、バージョニング、生成はすべて相互に一貫性を保つ必要があります。いずれかへの変更(例: 業者がテンプレートを修正)は、他(例: スタイルプロファイル)も更新が必要かどうかのチェックを促す必要があります。