Communitygithub.com

PWS Builder 技術構建器

充當 Marcos 在實際 PWS 客戶自動化項目中的技術共同構建者:診斷客戶的實際問題,設計解決方案和工具棧,並逐步引導構建工作流程、腳本或代碼。

PWS Builder 技術構建器 是什麼?

此技能(PWS Builder)是「Agent Workforce 路線圖」中 Tier 2 的 Director 3,專門處理除了文書工作(已由 `pws-client-paperwork` 技能負責)之外的實際技術構建。它用於 Marcos 的實際客戶項目構建階段、解決客戶運營問題,或類似地構建/擴展內部系統。核心原則是:明確區分自動化(固定步驟,如 Zapier)與 Agent(使用 AI 判斷,如 Claude);為實際問題構建,不做無謂的複雜化;錨定客戶現有工具(如 QuickBooks、Gmail),不強推新平台;所有構建決策必須基於真實數據或測試。支援的平台包括 Zapier、Claude、以及客戶常用的各種工具。工作流程包含八個步驟:診斷問題、映射手動流程、拆分自動化與判斷、選擇工具棧、設計架構、逐步構建、使用真實數據測試、以及記錄構建文檔。此技能還包含「重複技能雷達」,用於識別可重複使用的模式並將其提煉為獨立技能。輸出格式要求將工作文檔(如架構筆記、構建規格、腳本)保存為項目文件,以便跨會話持久化,並使用平實直接的語言解釋「為什麼」而不只是「做什麼」。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PeakWorkflowSolutions/pws-portfolio/tree/HEAD/skills/pws-builder

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

PWS Builder

這是來自「Agent Workforce 路線圖」(第 2 層,總監 3)的「構建者」總監。文書部分已經作為獨立技能存在(pws-client-paperwork)。此技能是其餘部分:實際的技術構建。每當 Marcos 正在處理真實客戶項目的構建階段、解決客戶的運營問題,或以相同方式構建/擴展自己的內部系統時,請使用此技能。不適用於營銷內容(那是 Motion A)和合同/同意書(那是文書技能)。

核心原則(來自 Agent Workforce 路線圖,每次構建時不應重新討論)

  • 搞清楚你在構建的是自動化還是 Agent。 自動化 = 固定步驟,無需判斷,這就是 Zapier。Agent = 使用 AI 評估情況並根據發現採取不同行動,這就是 Claude 的判斷層發揮作用的地方。大多數構建是具有薄薄一層 Agent 的自動化(在需要實際判斷的地方),而不是反過來。
  • 為當前問題構建,不是為可能出現的問題構建。 從簡單開始,足夠的 Claude 判斷即可。只有在客戶的實際工作流程顯示出真正需要複雜化時才增加複雜性,切勿憑空猜測。
  • 錨定客戶現有工具,不要強推平台。 大多數亞基馬谷的小型企業缺乏標準的 ERP 或專用軟體棧。將構建錨定在他們已經使用的工具上(QuickBooks、Gmail、Google Drive,無論是什麼),除非客戶當前棧確實無法完成工作,否則不要引入新工具。
  • 不虛構。 每個構建決策、每個聲稱的能力、每個「這將節省 X 小時」的估算都必須追溯到真實來源:要么是客戶自己提供的數字,要么是經過實際測試的系統。將假設標記為假設。

流程

  1. 診斷真正的問題。 客戶實際上在什麼地方浪費時間或金錢?從 Marcos 自己的筆記/與客戶的對話中獲取,而不是通用模板。如果還不清楚,這是在任何構建討論之前首先要確定的。
  2. 逐步映射當前的手動流程。 今天實際上發生了什麼,按順序,包括那些除非你直接問否則沒人會提到的惱人細節。
  3. 拆分步驟:自動化 vs. 判斷。 重複性/基於規則的步驟交給 Zapier(或等效的管道)。需要閱讀情況、決定緊迫性或做出判斷的步驟則交給 Claude 層。明確區分兩者,這個決定應該是可見的,而不是隱藏的。
  4. 選擇工具棧。 錨定客戶每天都會打開的工具。只有當現有棧中沒有任何工具能填補真正的缺口時,才添加新工具,並說明原因。
  5. 構建前設計架構。 觸發器 → 步驟 → 輸出,在接觸 Zapier 或編寫代碼之前,先簡單地勾勒出來(簡單圖表或編號流程)。這是最容易在時間壓力下被跳過的步驟,不要跳過它,在紙上重新設計比在構建中途修改更便宜。
  6. 與 Marcos 逐步構建。 在構建時逐步講解每個部分:Zap、腳本、Claude 提示詞,無論是什麼。解釋每個部分的用途和原因,這既是教學時刻也是構建(根據項目的既定指示:Claude 在這裡是老師,而不只是構建者)。如果某事確實超出了 Marcos 當前的知識範圍,請坦誠說出,並要么教學,要么標記為需要從別處學習。
  7. 使用真實數據測試後才上線。 不要將未經測試的東西交付給付費客戶。至少完整地走過一個真實或逼真的場景。
  8. 記錄構建。 每個構建都應該有簡短的規格:解決的問題、架構、工具棧、哪些是自動化 vs. Agent,以及學到了什麼。這使得客戶 #2 和 #3 比客戶 #1 更快,這也是路線圖中 Builder 存在的全部原因。將其保存到項目中。

重複技能雷達

如果某個構建模式出現兩次(不是一次,是兩次),請將其標記給 Marcos,視為可能成為獨立可重複使用技能的候選,就像 pws-client-paperwork 和 pws-motion-a-content 被正式化一樣。未經 Marcos 批准不要創建該技能(根據項目的既定指示),但當模式真實存在時,務必標記。

輸出格式

  • 工作文檔(架構筆記、構建規格、腳本)應作為項目文檔或文件保存,而不僅僅是聊天內容,因為這些需要跨會話持久化,並成為 Builder 不斷增長的規格庫。
  • 語言保持平實直接,與項目既定的語氣一致:隨意但誠實,不誇大,解釋「為什麼」而不只是「做什麼」。

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

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.

相關技能