Communitygithub.com

PWS入札書生成スキル

特定の事業者の既存テンプレートと表現を正確に再現し、案件固有の内容(範囲、価格、材料、スケジュール、顧客情報)のみを変更した、顧客にそのまま送れる建設業者向け入札書を生成します。

PWS入札書生成スキル とは?

このスキルは、建設業者(請負業者)向けの入札書・見積書生成システムです。最大の特徴は、業者ごとに異なるテンプレートのレイアウトや文体を一度抽出・学習し、その後の案件ごとには「案件固有の情報(作業範囲、価格、材料、スケジュールなど)」だけを差し替えて、そのまま顧客に送れる完成状態の入札書を生成する点です。 このスキルは、Claude APIを利用したパイプラインとして設計されており、実際の業者が直接Claudeにアクセスすることはありません。Googleフォーム(業者専用ツールに見えるプライベートリンク)→ Zapier → Claude API → 完成提案書(メールや共有ドライブで自動配信)という流れで動作し、運用者が毎回手動で介入する必要はありません。 主な利用シーンは、「入札書生成機能を構築・適応・トラブルシューティングするとき」「業者の入札スタイルを抽出するとき」「PWSの入札生成サービスに新しい業者をオンボーディングするとき」です。 重要な設計方針として、生成される入札書は常に「業者が確認・修正する草案」であり、スキルが自動で顧客に送信することはありません。また、法的・保証に関する文言は書き換えずにフラグを立てるポリシーを厳守します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/bid-generator-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

入札書生成スキル — 建設業者向け入札生成システム

ステータス: 完了 (v1)

以下の「設計上の決定」に記載された項目は、オンボーディング時に顧客ごとに調整するポイントであり、開発ブロッカーではありません。

システム概要

このシステムは、建設業者の既存の入札書と新しい案件の詳細を入力として、既存テンプレートと視覚的・構造的に同一で、案件固有の内容のみが差し替えられた新しい入札書を生成します。同じレイアウト、見出し、書式、ブランディングを維持し、業者が後で再フォーマットする必要がない、そのまま送れる最終版を出力することを目的とします。

2つのレイヤー:

  1. スタイル抽出 (各建設業者に対して1回、サンプル入札書から実行) — その業者の表現方法(トーン、言い回し、詳細の密度)とリテラルなテンプレート(レイアウト、セクション順序、書式、ブランディング)の両方を取得します。詳細は references/style-extraction-guide.md を参照。
  2. 入札書生成 (新しい案件ごとに実行) — スタイル/テンプレートプロファイルとプロジェクトインプットから完成した入札書を生成します。詳細は references/generation-workflow.md を参照。

譲れない設計上の決定 (ユーザーの確認なしに逸脱しないこと)

  • 出力 = 最終テンプレート、プレーンテキストではない。 建設業者のレイアウト、見出し、書式は毎回正確に再現する必要があります。入札書ごとに変更されるのは内容フィールドのみです。
  • 事実を invent しない。 作業範囲、価格、材料、スケジュールは、ユーザー/業者がその特定の案件について提供したもののみを使用します。スキルはスタイルプロファイルから表現方法と構造を借用することはできますが、ギャップを埋めるためにプロジェクトの詳細を捏造することは決してありません。
  • 業者の責任、オートパイロットではない。 生成されたすべての入札書は、顧客に送付される前に業者自身のレビューと修正を待つドラフトです。これはスキルが業者に代わって送信するものではありません。references/review-checkpoint.md を参照。
  • 法的/保証文言は書き換えず、フラグを立てる。 references/legal-guardrail.md を参照 — これはスタイルの選択ではなく、確固たるポリシーです。
  • バージョニングはルール抽出ではなく、変更前/変更後リファレンスを使用する。 references/versioning-approach.md を参照。

新しいクライアントの入札書生成機能を構築する際の手順

  1. 最初に references/bid-anatomy-residential-remodeling.md を読んでください。これは調査済みの、業界標準となる住宅リフォームの完全な入札書の骨格です(表紙、作業範囲、価格、スケジュール、支払いスケジュール、条件/法的セクションなど)。これを比較基準として使用します。業者の実際のサンプルがこれに一致する場合は確認、異なる場合は「修正すべきエラー」ではなく「プロファイルに記録すべきビジネス上の表現の選択」として扱います。
  2. references/style-extraction-guide.md を読み、業者の実際のサンプル入札書2~3以上に対して手順を実行し、スタイル/テンプレートプロファイルを構築します。
  3. 保証、責任、補償、ライセンス/保証、または支払い紛争に関する文言を含む入札書を生成する前に、references/legal-guardrail.md を読んでください。
  4. 入札書ごとのインプットと生成手順については references/generation-workflow.md を読んでください。
  5. 業者が生成された少なくとも1つの入札書の修正版を送り返してきたら、references/versioning-approach.md を読んでください。これにより、生成機能は時間とともに改善されます。
  6. references/review-checkpoint.md を読んで、「レビュー待ち」マーカーがすべての出力にどのように表示されるべきかを確認してください。

提供アーキテクチャ (クライアント企業が実際にこれをどのように使用するか)

決定事項: 建設業者はClaudeと直接やり取りすることはなく、スキル/プロジェクトへのアクセス権も持ちません。スキルの指示へのアクセスは運用者(Marcos)の知的財産であり、運用者のアカウント上にのみ保持されます。

パイプライン: Googleフォーム(プライベートリンク、業者専用ツールに見える)→ Zapier → このスキルの指示を使用したClaude API呼び出し → 完成した提案書が自動的に配信される(メールまたは共有Driveフォルダ)。一度構築すれば、運用者による手動ステップは不要です。これは lead-capture-skill ですでに使用されている「フォーム → Zapier → Claude → 配信」の形状を反映しており、リード獲得の代わりに入札書生成に適用した同じパターンです。

これが継続的な収益が成り立つ理由です。クライアントは、自分たちで再構築できるツールではなく、見ることも所有することもできないパイプラインに対して支払いを行っているのです。

将来 / まだ対象外 (v2以降)

  • 自動材料価格照会。 調査済みのアイデアですが、意図的に延期しています。建設業者がプレーンな材料リスト(品目 + 数量、できれば希望仕入先)を提出し、エージェントが指定された小売店/仕入先サイトから現在の価格を照会し、その価格結果が生成ステップに直接フィードされる — 手動でのスプレッドシート作成や再提出は不要。これがスコープに入ったときに対処すべき実際の注意点: 小売店サイトによって自動化の可能性は異なり、製品マッチングの精度は保証されず、価格出力はこのシステムの他のすべてと同様に業者が確認するドラフトとして扱う必要があります。コア生成機能が実際のクライアントの実際の入札書で動作し、実証されるまで構築しないでください。

設計上の決定とクライアントごとの調整

  1. 最小サンプル入札書数 — クライアントごとに調整。業界調査(bid-anatomy-residential-remodeling.md)は入札書の標準的な形状を説明していますが、一人の建設業者の実際の入札書が互いにどれだけ異なるかは教えてくれません。初期想定: 2~3以上、仕事の種類が大きく異なる場合はさらに多く。クライアントの実際のサンプルからクライアントごとに確認。
  2. 建設業者が実際に使用するドキュメント形式 — 解決済み。最終的な顧客向け成果物は、作成ツール(Word、Excelベースの見積もり、専用提案ソフトウェア)に関係なく、圧倒的に完成したPDFです。それでも、生成ツールが編集する元のテンプレート形式はクライアントごとに確認してください。出力がPDFに収束する場合でも、編集元が異なる可能性があるためです。詳細は bid-anatomy-residential-remodeling.md を参照。
  3. 職種別適応 — 種まき済み(v2拡張)。このスキルの現在の調査(bid-anatomy-residential-remodeling.md)は、特に住宅リフォームを対象としています。他の職種(屋根工事、配管工事など)向けの trade-adaptation-guide.md はv2拡張であり、lead-capture-skill と同じ適応ガイドパターンに従い、他の職種が調査またはオンボーディングされた後に作成されます。

主要原則

特定のクライアント企業に対して、スタイルとテンプレートの抽出、法的ガードレール、バージョニング、生成はすべて相互に一貫性を保つ必要があります。いずれかへの変更(例: 業者がテンプレートを修正)は、他(例: スタイルプロファイル)も更新が必要かどうかのチェックを促す必要があります。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

PeakWorkflowSolutions/pws-portfolio

Runs an AI Assistant Discoverability Audit (GEO/AEO) for a local service business — crawler access, llms.txt, content extractability, answer-shaped content, schema.org, NAP consistency, and live citation testing — output as a findings table + prioritized action list.

PeakWorkflowSolutions/pws-portfolio

Turns a new client's intake answers into a complete, ready-to-deploy PWS lead capture system package — Zap configs, the customized Claude prompt, Google Form fields, Sheet columns, and an owner's one-pager guide, all generated together from one intake conversation. Use this skill whenever onboarding a new client for PWS's missed-call lead capture system, whenever the user mentions "new client," "onboarding," "intake," or wants to set up the lead capture system for a specific business. This skill builds directly on top of lead-capture-skill — read that skill first if it's available, since this skill reuses its finalized prompt structure and system design.

PeakWorkflowSolutions/pws-portfolio

Scans top-performing content in a specific person's industry and local market, then builds a content playbook and tailored post ideas for lead generation. Use for Marcos's own content or any client's team/agents.

PeakWorkflowSolutions/pws-portfolio

Documents PWS's AI-Powered Missed Call Lead Capture System — an OpenPhone + Zapier + Claude + Google Forms/Sheets workflow that turns missed calls into captured leads automatically. Use this skill whenever building, adapting, explaining, or troubleshooting a missed-call lead capture system for a client, whenever the user mentions OpenPhone, Zapier lead capture, missed call automation, or a new client onboarding for PWS's flagship offer.

PeakWorkflowSolutions/pws-portfolio

Acts as Marcos's technical co-builder for a real PWS client automation project: diagnoses the client's actual problem, designs the solution and tool stack, and walks through building the workflow, scripts, or code step by step.

PeakWorkflowSolutions/pws-portfolio

Use when Marcos reports how a sales call went (in any wording, any time of day) so the lead's record in the Notion Prospects database gets updated.

PeakWorkflowSolutions/pws-portfolio

Generates branded, print-ready PWS service agreements, retainer terms, and consent/access forms from a client's real scope — one agreement per build, 20/80 payment, fillable Automation Builds table with auto-totaled price, black-and-white tables, no baked-in discount math.

PeakWorkflowSolutions/pws-portfolio

Use before Marcos's daily cold calls: pulls today's due leads from the Notion Prospects database and builds a researched, honest call script for each.

PeakWorkflowSolutions/pws-portfolio

Turns a recorded client meeting into a structured intake ready for the paperwork skill — pulls the Wispr Flow transcript, checks it against a fixed Scope/Timeline/Pricing/Payment/Access checklist, and publishes an interactive artifact so Marcos can fill in whatever the meeting didn't cover before it ends.

PeakWorkflowSolutions/pws-portfolio

Turns a new PWS video script/transcript into a ready-to-post batch of platform-specific social copy — the established priority channel set, brand voice, and per-platform formatting rules baked in.

PeakWorkflowSolutions/pws-portfolio

Runs the structured intake-to-demo pattern for a PWS website-build client: a fixed discovery questionnaire, a completeness check, and an auto-drafted first demo site built from the client's real answers with honest placeholders.

関連スキル