Communitygithub.com

PWSクライアント書類生成スキル

PWSのサービス契約、リテーナー契約、同意/アクセスフォームを、クライアントの実際のスコープからブランド化された印刷可能な形式で生成します。各ビルドにつき1契約、20/80支払い、自動合計価格が入力可能なAutomation Buildsテーブル、白黒テーブル、割引計算は含まれません。

PWSクライアント書類生成スキル とは?

このスキルは、Peak Workflow Solutions (PWS) のビルダーディレクターが、クライアントのオンボーディング書類を自動作成するためのものです。クライアントの実際のプロジェクトスコープ、価格、メモを基に、ブランド化されたサービス契約、リテーナー契約、およびクライアント同意・アクセス許可書を生成します。主にClaude CodeやCodex等のAIエージェント開発プラットフォームで動作し、docxライブラリを使用してWord文書を生成します。このスキルの核心は、1つのエンゲージメントにつき1つの契約書を生成し、20%着手金/80%完了時払いの支払い構造を適用することです。また、割引計算や標準料金との比較を文書に含めず、クライアントが実際に決定した価格のみを表示します。マーク・マルコスからの指示がない限り、金額や日付などの数値を推測して埋めることは禁止されており、空白のフィルラインとして残します。リテーナー契約の場合は、月額自動支払いと30日間の解約通知条項が含まれます。生成後はPDF変換、JPGレンダリング、各ページの画像確認による検証プロセスが必須であり、すべてのチェックが完了してから納品されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/pws-client-paperwork

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

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

ドキュメント

PWSクライアント書類生成スキル は何をしますか?

これはビルダーディレクターのオンボーディング書類作成プロセスです。スコープが決定したエンゲージメントを、署名可能でブランド化された文書に変換します。PWSマスターテンプレートを使用し、自分への指示が書かれたテンプレートではありません。このプロセスは、クライアント自身のプロジェクト(一般的なPWSプロジェクトではなく)で、実際のスコープ、価格、メモが手元にある状態で書類を作成する際に使用します。

トリガー

  • 新しいクライアントがサービス契約の準備ができている(1回限りまたは定期契約のいずれかのエンゲージメント)。
  • 既存のクライアントが、既に署名済みの契約とは別の、新しく明確なビルド(新しいSOW)を開始する。
  • クライアントのエンゲージメントに、対応するクライアント同意・アクセス許可書(PWSがクライアントのアカウント/ファイル/システムにアクセスする必要がある場合)が必要である。

中核となる判断基準(何かを書き始める前にこれらを決定し、決して推測しないこと)

  1. 1つのビルドに1つの契約書。巨大な1つの契約書にはしない。 同じようなタイムラインでスコープ/納品が行われる場合のみ、複数の成果物を1つの契約書にまとめる。タイムラインや準備状況が異なる場合は、個別の契約書に分割する。1つの契約書の「完了時に80%支払い」という条件は、そのExhibit A内のすべての項目がほぼ同時期に完了する場合にのみ機能する。それぞれの独立した契約書には、契約書上部の入力可能フィールドを使用して、独自の「フェーズ」(フェーズ1、フェーズ2...)というラベルを付けることができる。理想的にはクライアント自身が指定した優先順位に従う。これは、完全で個別に価格設定された文書に対するラベルであり、1つの文書のスコープを価格設定された部分と未定の保留部分に分割する方法ではない。
  2. 支払い構造: 1回限りの作業は定額料金で、署名時に20%、完了時に80%が支払われる。「料金と支払い」セクションには、独自の金額は印刷されない。代わりに、Exhibit Aの「Total Initial Build Price」を唯一の情報源として参照する(「Scope of Workの総額はExhibit Aに記載されたTotal Initial Build Priceです」)。定期/リテーナー作業は、この20/80の分割に組み込まれてはならない。独自の「定期サービス、自動支払い、および解約」セクションに、自動支払いの承認と30日間の書面による解約通知(毎月請求)を含めて記載する。
  3. 割引計算を印刷しない。 標準料金との比較、「X%お得」、「初めてのお客様料金」などの表現を文書自体に含めない。マルコスは割引を提示する際に口頭で伝える。文書は単に料金を記載する。導入事例/再販権の要請(使用する場合)は、割引との交換条件としてではなく、独立した条項として扱う。
  4. 数値を捏造しない。 料金、目標日、月間包含時間、応答時間 — マルコスが実際の数値を提示していない場合は、空白のフィルラインとして残し、決して推測しない。クライアント自身のメールやメモから実際のスコープ文言を引用する。元の情報にアクセスできる場合は、記憶に基づいて言い換えない(Gmail/Notionで確認すること)。
  5. リテーナー契約の内容(該当する場合): 含まれるもの(監視、接続プラットフォームの変更による障害の修正、月間作業時間/調整の上限)、応答時間の約束、自動支払いの承認、および30日間の解約通知。マルコスに提案するための開始価格の目安(印刷用ではない):監視のみで月額約$150~$250、リードジェネレーションチャネル調整などのアクティブな作業が含まれる場合は月額最大$350~$500 — 常に、クライアントが既に示している価格感度のシグナルを大きく下回る価格であること。

ビルドプロセス

  1. 実際の入力を収集する。 クライアントの法的名称/商号、発効日(または空白)、実際のスコープ項目(クライアントのメール/メモから引用し、記憶に基づいて言い換えない)、各項目が1回限りか定期か、そしてマルコスが実際に決定した価格。まだ決定されていないものについては、推測せずに直接マルコスに確認する。
  2. 共有ブランドモジュールを使用する(この環境にない場合は再構築する。以下のスニペットからbrand.jsに再現し、PWSロゴのトリミングされたコピーと共に配置する):
const BRAND = {
 navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
 bodyFont: "Times New Roman", // 汎用的なプロフェッショナル/法的文書用セリフ体
 headingFont: "Poppins", // 太字の幾何学的サンセリフ体、PEAKロゴを反映
};
function docStyles() {
 return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): ロゴ画像 + 太字のネイビータイトル(フォント: BRAND.headingFont)をオレンジの罫線の下に配置
// footer(): 中央揃え「Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com」、小文字、グレー、上部に青い罫線
// h1(text) / h2(text): 太字ネイビーの見出し、フォント: BRAND.headingFont

すべてのnew Document({...})呼び出しに...docStyles()を展開し、本文テキストがデフォルトでTimes New Romanになるようにする。見出しとレターヘッドは明示的にPoppins Boldにオーバーライドする。

  1. テーブルヘッダーは白黒で、色を付けない。 以前のバージョンではヘッダーセルをネイビーで塗りつぶしていた。ヘッダーテキストに明示的な色が設定されていなかったため、一部の画面では黒字にネイビー背景でコントラストが低くなっていた。テーブルヘッダーは、白地に太字の黒テキストで、プレーンなグリッド線の境界線のみとする。ヘッダーセルにshade/塗りつぶし色を再導入しない。

  2. 空白フィルライン:テーブルセル内では短い空白を使用する。 標準の空白フィルライン(U = "________________"、16アンダースコア)は本文テキストと幅の広いセル用である。より狭いテーブルセル(タイムライン列、合計行の価格セル)では、2行に折り返されて見栄えが悪くなる。代わりに、そこでは短い空白(US = "__________"、10アンダースコア)を使用する。

  3. 標準セクションフロー(docx-jsをdocxスキル経由で使用):冒頭/当事者ブロック、次に入力可能な「フェーズ ___ — ___(エンゲージメント名)」行。「サービスとScope of Work」、「期間」、「料金と支払い」(番号付き条項:[料金 [Exhibit Aの合計を参照し、個別の金額欄は設けない]、支払いスケジュール [20/80、個別の金額欄は設けない]、追加スコープは新しい契約へ、請求書発行、遅延支払い])、[定期サービス、自動支払い、および解約 — このエンゲージメントにリテーナー要素がある場合のみ]、「クライアントの責任」、「クライアントのシステムとデータへのアクセス」、「知的財産と再販権」(クライアント固有の成果物、プロバイダーツール、導入事例、再販権)、「機密保持」、「保証と免責事項」、「責任の制限」、「独立請負業者」、「契約解除」、「準拠法」、「完全合意と修正」、改ページ、「Exhibit A」、「署名」。

  4. Exhibit Aの構造 — 常にこの形式を使用する:

  • 「Automation Builds」テーブル:列:Automation | Description | Timeline | Initial Build Price。このエンゲージメントの個々の自動化/成果物ごとに1行。20行のプロジェクトは20行、2行のプロジェクトは2行。マルコスが実際の明細(名前、説明、タイムライン、価格)を提供した場合は、空白のままにせず、各行を直接入力する。最後に下の行として、最初の3列を結合(columnSpan: 3)し「Total Initial Build Price」と表示し、最後の列に金額の合計を表示する — すべての明細に実際の価格が設定されている場合は、自分で各行の価格を合計すること。1つ以上の明細の価格が未定の場合は、空白のフィルラインとして残す。
  • その直下に「Monthly Retainer / Maintenance」セクション、3列のみの小さな独自テーブル:Frequency | Fee | Autopay(「Service」列はなし。マルコスは、エンゲージメントにリテーナー行が1つしかない場合に何を入れるべきか不明確だと判断した)。Frequencyには「Monthly」が事前入力され、Autopayには「☐ Authorized (Section 4.3)」チェックボックスが含まれる。このテーブルは、エンゲージメントに定期コンポーネントがある場合にのみ含める。それ以外の場合は、「No recurring maintenance or retainer service applies to this engagement.」と明記する(セクションを削除するのではなく、すべてのExhibit Aの形状を統一するため)。
  1. 番号付けの注意点(docx-js特有、既に2回ヒットしているので繰り返さないこと):
  • numbering.reference文字列は、ドキュメント全体で再利用すると、連続してカウントされる。各番号付き条項ブロック(料金、定期、IP)には、独自のreference名(例:clausesFees、clausesRecurring、clausesIP)を付け、"clauses"のような共通のreferenceを決して共有しない。
  • ドキュメントのセクションリストが変動する場合(例:定期セクションの有無)、「Section 4」/「Section 12」のようなテキストを手動で入力しない。セクションが追加または削除されるたびにずれる可能性がある。セクションキーの順序配列を事前に計算し、各キーに一度番号を割り当て、その番号を相互参照に使用する。パターンを参照:sectionOrder(条件付きで"recurring"を含める)を構築し、secNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1)とし、本文内でセクション番号が記載されている場所ではsecNum.terminationなどを参照する。
  • TableCellは、結合されたTotal行を構築するためにcell()ヘルパーにcolumnSpanオプションをスレッドする必要がある。古いcell()ヘルパーを再利用する場合は、width/shadeのみを処理するものであるため、追加することを忘れないこと。
  1. 対応する同意・アクセス許可書を作成する — 新しいシステムに触れるすべてのエンゲージメントに対して。異なるビルドのために古いエンゲージメントのアクセステーブル行を再利用しない。同じブランディング、同じ白黒の空欄入力可能なテーブルパターン(System/Account、Specific Item、Access Granted、Purpose)。

  2. 納品前に毎回検証する: PDFに変換し(docxスキルのsoffice.py --headless --convert-to pdfスクリプトを使用)、JPGにレンダリングし(pdftoppm -jpeg -r 100)、実際に各ページ画像をReadして確認する:ブランディングが正しいか、セクション番号が連続しており相互参照が一致するか、割引/標準料金の表現が紛れ込んでいないか、空白が本当に空白か(以前のクライアントの古い数値が残っていないか)、短い空白で見苦しい行折り返しがないか、Automation Buildsの合計が実際に行の合計と一致しているか。再検証せずに再ビルドを納品しないこと。

  3. SendUserFileで納品し、構築した内容と価格/構造に関する決定事項を、そのクライアント自身のプロジェクト/ビルドログに記録する。一般的なPWSプロジェクトには記録しない。

検証

  • マルコスが明示的に指定した場合を除き、文書内に金額、日付、時間数が表示されていない
  • 割引計算、割引率、「初めてのお客様料金」などの表現がどこにもない
  • すべての定期サービスは、独自のセクション(自動支払い + 30日間解約通知)の下にあり、1回限りの20/80分割内には決して含まれていない
  • セクション番号は、実際にレンダリングされたPDFから読み取られており、コードから推測されたものではない
  • Exhibit AのTotal Initial Build Priceが、入力された明細項目の合計と一致している
  • 「料金と支払い」セクションは、独自の個別の金額欄を印刷するのではなく、Exhibit Aの合計を参照している
  • テーブルヘッダーは、白地に太字の黒テキスト — 色の網掛けはどこにもない
  • リテーナーテーブルは正確に3列(Frequency | Fee | Autopay)であり、Service列はない
  • ブランディング(ロゴ、ネイビー/ブルー/オレンジ、Times New Roman本文 / Poppins Bold見出し、フッター)がすべてのページで一致している
  • クライアントが実際に署名する前に、ライセンスを持つワシントン州の弁護士がレビューする必要があることを伝えたことを確認するリマインダーが含まれている

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

Generates client-ready contractor bids that reproduce a specific business's own template and voice exactly, changing only the job-specific content (scope, price, materials, timeline, client info). Use this skill whenever building, adapting, or troubleshooting a bid/proposal generator for a contractor business, whenever the user mentions "bid generator," "proposal generator," extracting a business's bid style, or onboarding a new contractor client for PWS's bid generation offer. Status: Complete (v1).

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

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.

関連スキル