pro

pro skill 概览

pro 适合做什么

pro skill 是 tanweai/pua 系统上的一层扩展，重点不在单次生成内容，而在于工作流持久化、自进化追踪、KPI 风格汇报，以及周报、述职、排行榜这类平台化命令。实际使用中，pro 的核心价值不是“帮你写一段文字”，而是让助手在跨会话时保持连续性，表现得像是记得你的标准、压力和进度。

哪些用户最适合使用 pro

如果你需要的不是普通 prompt 那种一次性输出，而是更有结构的 Workflow Automation，尤其涉及周期性复盘、状态跟踪、自我改进日志，以及上下文压缩后的会话恢复，那么 pro 会更合适。它更适合有固定工作节奏、反复执行同类任务的人，而不是偶尔随手聊几句的轻度场景。

pro 真正解决的是什么问题

大多数考虑使用 pro 的用户，本质上是在解决以下四类问题之一：

• 让进度规则在多个会话之间持续保留
• 避免在 compaction 或中断之后丢失状态
• 稳定生成 KPI、周报、述职这类周期性的管理型输出
• 增加轻量的平台机制，比如排行和进化追踪

如果你的需求正是这些，那么 pro 提供的就不只是“帮我写个周报”这种通用 prompt，而是一套更有操作性的工作规则。

pro 最大的区别在哪里

pro 最关键的差异，在于它会明确检查并使用 ~/.pua/ 下的状态文件，包括：

• ~/.pua/evolution.md
• ~/.pua/builder-journal.md
• ~/.pua/config.json

这意味着 pro 不是一个单纯控制文风的 prompt，而是一层有状态的运行机制。它最强的价值在连续性：启动时加载基线、在 compaction 后恢复上下文、以及把反复出现的优选模式提升为默认行为。

安装 pro 之前要先知道什么

从仓库可见内容来看，pro 的主要证据集中在一个 SKILL.md 文件中。概念本身很清楚，但文档引用的配套文件在当前目录预览里并没有展开。因此，pro 在高层设计上不难理解，但其中部分行为很可能依赖上层 pua 系统的完整运行环境，而不是这个 skill 目录单独就能实现。

如何使用 pro skill

pro 的安装前提

当前仓库证据里，skills/pro/SKILL.md 没有展示专门的安装命令。如果你使用的是兼容 skills 的 runner，应从上层仓库安装，并按你的工具所支持的 skill 安装语法选择 pro。如果你本身已经在使用 pua，更适合把 pro 理解为扩展层，而不是一个独立安装包。

先读这个文件

先看：

• skills/pro/SKILL.md

因为在当前预览中，这个 skill 只看得到一个文件，所以几乎所有实际行为都写在这里：触发方式、启动检查、compaction 恢复，以及命令模式。

先理解 pro 的触发模型

pro 的设计是通过明确短语和命令式模式触发的，包括：

• /pua:kpi
• /pua:pro
• /pua:pro 段位
• /pua:pro 周报
• /pua:pro 述职
• /pua:flavor
• /pua:pro 排行榜
• leaderboard
• 排行榜
• 自进化
• evolution

如果你想稳定使用 pro，优先使用这些明确触发词，而不是模糊描述。命令面越清晰，pro 越可能进入你想要的那条工作流。

pro 需要你提供哪些输入

pro skill 在以下信息明确时效果最好：

• 你想要的输出类型：KPI、周报、述职总结、排行榜、进化更新
• 时间范围：今天、本周、本月、上季度
• 评估依据：目标、指标、事件、成果、失败
• 原始材料：笔记、已完成任务、commits、tickets 或 bullet points
• 这是一次全新执行，还是一次中断后的续跑

如果没有具体输入材料，pro 依然能帮你排版成型，但很难产出可信度高的复盘结果。

如何把模糊目标改成高质量的 pro 提示词

弱一点的写法：

• “Use pro to write my report”

更强的写法：

• “Use pro for a weekly report. Time range: Monday to Friday. Inputs: 6 completed tasks, 2 blockers, 1 missed target, and 3 measurable outcomes. Emphasize impact, risk, next actions, and what improved from last week.”

最佳写法：

• “Run pro as a weekly report workflow. Recover any prior state if relevant. Summarize this week by goals, delivery, blockers, lessons, and next-week commitments. Use these notes: [paste bullets]. Call out measurable wins, one shortfall, and one pattern that should become default behavior.”

之所以后两种写法更好，是因为它们同时给了 pro 汇报框架、证据材料，以及进化判断依据。

pro 如何处理持久状态

使用 pro for Workflow Automation 的一个核心理由，就是它的状态模型。这个 skill 描述了启动时会检查以下内容：

• ~/.pua/evolution.md：用于加载基线和已内化的模式
• ~/.pua/builder-journal.md：用于恢复进行中的会话状态
• ~/.pua/config.json：用于平台配置相关行为

如果你的环境无法读取或持久化这些文件，那么 pro 相比普通 prompt 的很多关键差异都会丢失。

为什么 compaction 保护很重要

pro 在 compaction 恢复上的说明非常具体。发生 compaction 之前，系统预期会导出这类运行时状态：

• pressure_level
• failure_count
• current_flavor
• pua_triggered_count
• active_task
• tried_approaches
• excluded_possibilities
• next_hypothesis
• key_context

下次会话启动时，如果这些状态还足够新，就可以重新加载。对于需要长链路、容易被打断的工作流用户来说，这是采用 pro 最有吸引力的理由之一。

首次使用 pro 的推荐流程

1. 打开 SKILL.md，先找出最符合你场景的触发方式。
2. 判断自己需要的是汇报命令、进化行为，还是会话恢复。
3. 确认你的运行环境是否真的支持 ~/.pua/ 文件持久化。
4. 从一个明确请求开始，例如 /pua:kpi 或 /pua:pro 周报。
5. 提供结构化证据，而不仅仅是一个主题。
6. 输出完成后，判断结果应该更新到基线，还是只保留为一次性产物。

pro 首次测试最合适的场景

适合拿来验证 pro usage 的首批场景包括：

• 基于真实笔记生成周报
• 在一次中断会话后恢复上下文
• 用可量化结果生成 KPI 总结
• 在多个会话里重复某种偏好模式后，测试进化行为是否生效

这些场景最能看出 pro 的有状态部分，在你的环境里到底有没有真正跑起来。

什么情况下普通 prompt 就够了

如果你只是一次性需要一份成型、体面的报告，那么普通 prompt 往往比 pro install 和额外设置更简单。只有当重复性、连续性或平台化机制开始变得重要时，pro 的价值才会明显上升。

采用 pro 之前的实用判断

如果你需要以下能力，可以考虑采用 pro：

• 可重复执行的汇报工作流
• 持久化的行为基线
• 对 compaction 更安全的会话连续性
• 通过命令直接调用，而不是每次重写 prompt

如果你更想要的是以下体验，那就不太适合：

• 通用型的大而全 agent framework
• 不依赖上层系统上下文的完整独立文档
• 零状态、纯浏览器式的 prompt 使用体验

pro skill 常见问题

pro 是独立 skill，还是 pua 的一部分

从仓库结构来看，pro 属于更大的 pua 仓库，并被描述为 /pua core 的扩展层。更准确的理解是：它是一个专用模块，而不是完全独立的系统。

pro 适合新手吗

适合，但前提是你通过 /pua:kpi 或 /pua:pro 周报 这类明确命令来使用它。不适合的情况是：你希望它在完全不了解上层 pua 模型、也不了解文件状态机制的前提下，自动推断出全部运行假设。

为什么用 pro，而不是普通 prompt

最大的优势是连续性。普通 prompt 能写出一份报告，但 pro 的目标是保留基线行为、恢复中断上下文，并在多次会话中追踪持续出现的改进模式。

pro 的主要限制是什么

最大的限制是对环境有依赖。pro skill 引用了当前这个可见 skill 文件之外的文件和协议。如果你的部署环境不支持这些文件，那么它宣传的一些能力就可能退化为普通的指令跟随。

pro 必须用中文命令吗

不完全是。它有些触发词是命令式的，也有一些是中文短语，比如 排行榜 和 自进化。同时也能看到 leaderboard、evolution 这样的英文线索，因此可以预期它的命令面本身就是中英混合的。

pro 适合做 Workflow Automation 吗

适合。pro for Workflow Automation 在以下场景中是合理选择：你需要周期性周报、KPI 汇总，或在被打断的工作会话之间恢复状态。相比之下，如果只是临时 brainstorm，它的吸引力就没那么大。

什么情况下不该用 pro

以下情况不建议使用 pro：

• 你只需要一次性格式化输出
• 你的 agent 环境无法持久化 ~/.pua/ 文件
• 你希望所有依赖都在 skill 文件夹内完整说明
• 你更偏好简单 prompt，而不是命令触发式工作流

如何把 pro skill 用得更好

给 pro 的是证据，不是主题

提升 pro usage 效果最快的方法，就是提供具体素材，例如：

• bullet notes
• metrics
• completed tasks
• blockers
• before/after results
• decisions made

“Write a strong report” 只会得到泛泛而谈的文字；“Summarize these five outcomes and two risks into a KPI-style report” 才真正给了 pro 可以推理和组织的对象。

用和任务最匹配的准确命令

不要模糊地说“来点专业的”。直接使用最接近目标输出的命令或触发词：

• /pua:kpi 用于 KPI 风格复盘
• /pua:pro 周报 用于周报
• /pua:pro 述职 用于述职或绩效型叙述
• /pua:pro 排行榜 用于排行机制
• evolution 或 自进化 用于基线改进行为

这样可以显著减少歧义，也能让 skill 更快进入正确分支。

让状态持久化真正可用

如果你想把 pro 的价值发挥出来，务必确认环境能读写：

• ~/.pua/evolution.md
• ~/.pua/builder-journal.md
• ~/.pua/config.json

没有这一层，skill 会失去大量恢复逻辑和基线逻辑。这是影响输出质量最关键的实现细节。

提升周报和 KPI 输出质量的方法

想让报告更扎实，建议至少补充：

• 时间范围
• 目标与实际结果对比
• 关键成果
• 明显失误或未达成项
• 根因分析
• 下一步动作
• 一条应该升级为默认行为的经验

最后这一项尤其贴合 pro 的 evolution 模型，能让输出不止是回顾，而是进入持续改进。

避开最常见的失败方式

最常见的失败方式，是把 pro 当成一个神奇格式化器，却不给任何上下文。第二常见的问题，则是默认认为 compaction 恢复会自动生效，但实际环境根本不会持久化本地文件。

在第一次输出后继续迭代

当 pro 生成报告或总结后，可以继续追问这些问题来提升结果：

• 哪些内容应该加入基线
• 哪些重复出现的行为应该成为默认模式
• 还有哪些证据缺失
• 哪些地方表现不佳，但不应该拉低基线
• 下一次会话的 checkpoint 应该保存什么

这些追问更贴近这个 skill 的真实机制，而不是停留在泛泛的“再润色一下”。

把 pro 当成持续系统，而不是单次 prompt

pro skill 的真正价值会在多次会话中体现。如果你只用一次，得到的主要还是一份格式化输出；如果你持续使用，并保持输入稳定、状态可保存，那么你得到的会是连续性、可比较性，以及进化追踪。

用采用者视角来读 pro skill

由于当前可见实现几乎都集中在 SKILL.md，建议按这个顺序阅读：

1. trigger list
2. session startup checks
3. compaction state protection
4. command system

按这个路径看，你能更快判断 pro install 值不值得投入时间，以及你的运行环境能不能支撑那些真正重要的部分。