Communitygithub.com

PWS 构建器

作为 Marcos 的技术共建者,专注于实际客户自动化项目:诊断客户真实问题、设计解决方案和技术栈,并逐步指导工作流、脚本或代码的构建过程。

PWS 构建器 是什么?

PWS 构建器技能源自 Agent Workforce 路线图(第2层,第3指挥),是 Marcos 处理实际客户技术构建阶段的核心工具。它专注于诊断客户运营问题,设计基于现有工具(如 QuickBooks、Gmail、Google Drive)的解决方案,并逐步指导从自动化到智能代理层的构建过程。该技能强调“为现有问题构建”原则,避免过度设计,并坚持“不虚构”原则,确保每个决策都有真实依据。它支持 Claude Code 等平台,通过诊断问题、映射当前流程、拆分自动化与判断步骤、选择工具栈、设计架构、逐步构建、测试和记录文档的八步流程,帮助客户高效解决问题,同时积累可复用的技能模式。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

PWS 构建器 是做什么的?

这是 Agent Workforce 路线图中的“构建器”指挥(第2层,第3指挥)。文档部分已经作为独立技能存在(pws-client-paperwork)。本技能涵盖其余部分:实际的技术构建。每当 Marcos 处理实际客户项目的构建阶段、解决客户运营问题,或以相同方式构建/扩展自己的内部系统时,请使用此技能。不适用于营销内容(那是 Motion A 的职责)或合同/同意书(那是文档技能的职责)。

核心原则(来自 Agent Workforce 路线图,无需在每个构建中重新讨论)

  • 知道你在构建自动化还是代理。 自动化 = 固定步骤,无需判断,这是 Zapier 的领域。代理 = 使用 AI 评估情况并根据发现采取不同行动,这是 Claude 判断层发挥作用的地方。大多数构建是带有薄层代理判断的自动化,而不是相反。
  • 为当前问题构建,而不是为可能遇到的问题。 从简单的开始,只加入够用的 Claude 判断。复杂化应等到客户实际工作流揭示出真实需求后,永远不要推测性地添加。
  • 以客户现有工具为基础,不要强制推广平台。 亚基马谷的大多数小企业没有标准的 ERP 或专用软件栈。以他们已有的工具(QuickBooks、Gmail、Google Drive 等)为基础,除非客户当前栈确实无法胜任工作,否则不要引入新工具。
  • 不虚构。 每个构建决策、每个声称的能力、每个“这将节省 X 小时”的估算都必须有真实依据,要么来自客户自己给出的数字,要么来自实际测试过的系统。将假设标记为假设。

流程

  1. 诊断真实问题。 客户在哪个环节损失时间或金钱?从 Marcos 自己的笔记/与客户的对话中获取,而不是使用通用模板。如果问题尚不明确,首先需要确定这一点再进行任何构建讨论。
  2. 映射当前手动流程,逐步骤进行。 今天实际上是怎么做的?按顺序,包括你不直接问就没人会提到的烦人环节。
  3. 拆分步骤:自动化与判断。 重复/规则驱动的步骤交给 Zapier(或类似的管道工具)。需要理解情境、判断优先级或做出决策的步骤则赋予 Claude 层。明确说明哪些属于哪一类,这个决策应该是透明的,而不是隐藏的。
  4. 选择工具栈。 以客户每天已经打开的工具为基础。只有在现有栈确实无法弥补真实缺口时才添加新工具,并说明原因。
  5. 在构建前设计架构。 触发 → 步骤 → 输出,在接触 Zapier 或编写代码之前,用简单的图表或编号流程清晰地勾勒出来。这是在时间压力下最容易被跳过的一步——不要跳过,在纸上重新设计比在构建中返工更便宜。
  6. 与 Marcos 逐步构建。 边构建边讲解每个部分:Zap、脚本、Claude 提示词或其他内容。解释每个部分的作用及原因——这既是构建过程,也是教学时刻(根据项目的既定指示:Claude 在这里是老师,而不仅仅是构建者)。如果某些内容确实超出 Marcos 当前的知识范围,明确说明,要么教学指导,要么标记为需要在别处学习。
  7. 使用真实数据测试后再上线。 不要向付费客户交付未经测试的内容。至少完整走一遍一个真实或逼真的场景。
  8. 记录构建过程。 每个构建都附带简短规格说明:解决的问题、架构、工具栈、自动化与代理的划分,以及学到的经验。这就是为什么第二个和第三个客户比第一个客户更快——这正是路线图中 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.

相关技能