pro

pro skill 概覽

pro 是做什麼用的

pro skill 是 tanweai/pua 系統上的一層擴充，重點放在工作流程持續化、自我演進追蹤、KPI 式報表，以及像是週報、述職摘要、排行榜這類平台化指令。實際上，pro 的核心不在單次內容生成，而是在多個 session 之間維持連續性，讓助理表現得像是真的記得標準、壓力與進度。

哪些人最適合用 pro

pro 特別適合那些需要比一般 prompt 更有結構的使用者，尤其是拿來做 Workflow Automation，例如定期檢視、狀態追蹤、自我改進紀錄，以及在 context 被壓縮後恢復 session。若你的工作是反覆循環、固定節奏地進行，pro 會比一次性的閒聊或臨時提問更合適。

真正要解決的工作需求

大多數考慮使用 pro 的人，通常是在解決以下四類問題之一：

• 在不同 session 之間保留進度規則
• 避免在 context compaction 或中斷後遺失狀態
• 產出重複性的管理型輸出，例如 KPI、週報、述職摘要
• 加入輕量的平台機制，例如排名與演進追蹤

如果這正是你的使用場景，pro 提供的就不只是「幫我寫一份週報」這種泛用 prompt，而是更具操作性的流程規則。

pro 有什麼不同

pro 最明顯的差異，在於它會明確檢查並使用 ~/.pua/ 底下的狀態檔案，包括：

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

這種設計讓 pro 成為一層有狀態的操作邏輯，而不只是風格化 prompt。它最大的價值在於連續性：載入基準、在 compaction 後恢復、以及把反覆出現的好模式提升為預設行為。

安裝前你該先知道的事

目前 repository 中與 pro 相關的證據，主要集中在單一一份 SKILL.md。概念本身很清楚，但文件提到的支援檔案，在目前的 tree preview 裡並沒有直接展示出來。這表示 pro skill 在高層次上不難理解，但部分行為可能依賴父層 pua 系統的完整 runtime 環境，而不是只靠這個 skill 資料夾就能完整運作。

如何使用 pro skill

pro 的安裝脈絡

目前 repo 可見內容中，skills/pro/SKILL.md 並沒有提供獨立的 install 指令。如果你使用的是支援 skills 的 runner，應該從父層 repository 安裝，並依照你的工具所用的 skill install 語法選用 pro skill。若你本來就在使用 pua，比較適合把 pro 視為擴充層，而不是獨立套件。

先讀這個檔案

先從這裡開始：

• skills/pro/SKILL.md

因為在目前 preview 中，這個 skill 只看得到一個檔案，所以幾乎所有實際行為都寫在裡面：觸發條件、啟動檢查、compaction 復原，以及指令模式。

先理解 pro 的觸發模型

pro 的設計是靠明確片語與指令式模式來啟動，包括：

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

如果你希望 pro 穩定發揮作用，建議優先使用這些明確 trigger，而不是下模糊需求。當指令表面形式夠清楚時，這個 skill 更有可能走到你真正要的工作流程。

pro 需要什麼輸入

pro skill 在以下資訊齊全時效果最好：

• 你要的輸出類型：KPI、週報、述職摘要、排行榜、演進更新
• 時間範圍：今天、本週、本月、上季
• 評估依據：目標、指標、事件、成果、失誤
• 原始素材：筆記、已完成任務、commits、tickets 或條列重點
• 這次是全新執行，還是中斷後的延續

如果沒有具體輸入材料，pro 仍然可以幫你排版出一份成品，但很難穩定產出可信度高的檢視結果。

把模糊需求改寫成更強的 pro prompt

弱：

• 「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 for Workflow Automation 的一大原因，就是它的狀態模型。這個 skill 在描述中提到，啟動時會檢查：

• ~/.pua/evolution.md：用來存放基準與已內化的模式
• ~/.pua/builder-journal.md：用來恢復進行中的 session 狀態
• ~/.pua/config.json：用來控制平台層級的設定行為

如果你的執行環境無法讀取或持久化這些檔案，pro 與一般 prompt 最大的差異就會流失很多。

為什麼 compaction 保護很重要

pro 指南對 compaction recovery 的描述相當具體。系統在 compaction 前，理論上應該把執行中的狀態寫出來，例如：

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

在下一次 session 開始時，只要這些資料還夠新，就可以重新載入。對於工作流程長、又常被中斷的使用者來說，這是採用 pro 最有說服力的理由之一。

第一次使用建議流程

1. 打開 SKILL.md，先找出哪個 trigger 最符合你的情境。
2. 決定你要的是報表型指令、演進行為，還是 session 復原。
3. 確認你的 runtime 是否真的支援 ~/.pua/ 檔案持久化。
4. 從一個明確請求開始，例如 /pua:kpi 或 /pua:pro 周报。
5. 提供結構化證據，而不只是丟一個主題。
6. 輸出完成後，判斷這次結果應該更新 baseline，還是只作為一次性產物。

最適合第一次測試的情境

很適合作為 pro usage 首次測試的場景包括：

• 用真實筆記生成一份週報
• 在 session 中斷後恢復上下文
• 根據可量化成果產出 KPI 摘要
• 在多個 session 重複某種偏好模式後，測試演進行為

這些情境最能看出 pro 有狀態的那一面，是否真的在你的環境中正常運作。

什麼時候一般 prompt 就夠了

如果你只需要一次性的精修報告，直接用一般 prompt 往往比 pro install 加設定更簡單。只有在重複性、連續性，或平台化機制真的重要時，這個 skill 的價值才會明顯放大。

採用前的實用適配檢查

如果你需要以下能力，適合採用 pro：

• 可重複使用的報表工作流程
• 可持續保留的行為 baseline
• 能承受 compaction 的 session 連續性
• 透過指令呼叫，而不是每次重建 prompt

如果你想要的是以下條件，就可以考慮略過：

• 通用型、廣泛用途的 agent framework
• 不依賴父系統脈絡、而且文件完整的獨立方案
• 零狀態、只靠瀏覽器就能跑的 prompt 體驗

pro skill 常見問題

pro 是獨立 skill，還是 pua 的一部分

從 repository 結構來看，pro 是較大 pua repository 的一部分，文件中也把它描述為 /pua 核心的擴充層。比較準確的理解方式，是把它當成專門模組，而不是完全獨立的系統。

pro 適合新手嗎

適合，但前提是你願意用像 /pua:kpi 或 /pua:pro 周报 這樣的明確指令來操作。若你期待這個 skill 在不了解父層 pua 模型或檔案狀態機制的情況下，自動推斷所有運作假設，那就不太適合新手。

為什麼要用 pro，而不是一般 prompt

最大的優勢是連續性。一般 prompt 也能寫出一份報告；但 pro 的目標是保留 baseline 行為、恢復中斷的上下文，並長期追蹤反覆出現的改進模式。

pro 的主要限制是什麼

最大限制在於它相當依賴環境。pro skill 引用了單一可見 skill 檔案以外的檔案與協議。如果你的環境不支援那些檔案，部分主打能力就可能退化成單純的指令跟隨，而不是完整的狀態化流程。

pro 一定要用中文指令嗎

不一定。有些 trigger 是指令格式，有些則是中文片語，例如 排行榜 與 自进化。同時也能看到像 leaderboard 與 evolution 這類英文線索，但整體來看，使用者應該預期這是一個中英混用的指令表面。

pro 適合用在 Workflow Automation 嗎

適合。pro for Workflow Automation 很適合用在需要反覆輸出週摘要、KPI 彙整，或在工作 session 中斷後恢復狀態的情境。若只是臨時性的發想腦暴，它的吸引力就沒那麼高。

什麼情況下不該用 pro

以下情況不建議使用 pro：

• 你只需要一次性的格式化輸出
• 你的 agent 環境無法持久化 ~/.pua/ 檔案
• 你希望所有依賴都在 skill 資料夾內完整說明
• 你偏好簡單 prompt，而不是指令觸發型工作流程

如何把 pro skill 用得更好

給 pro 證據，不要只給主題

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

• 條列筆記
• 指標
• 已完成任務
• 阻塞項
• 前後結果對比
• 已做決策

「Write a strong report」只會得到泛泛的文字；「Summarize these five outcomes and two risks into a KPI-style report」才真正給了 pro 可以推理的內容。

用最貼近任務的精確指令

不要模糊地要求「做得專業一點」。請直接使用最接近目標輸出的指令或 trigger：

• /pua:kpi：用於 KPI 式檢視
• /pua:pro 周报：用於週報
• /pua:pro 述职：用於述職或績效敘事
• /pua:pro 排行榜：用於排名機制
• evolution 或 自进化：用於 baseline 演進行為

這樣能降低歧義，也能更快觸發 skill 中正確的分支。

讓狀態持久化真正可用

如果你想把 pro 的價值吃滿，務必確認你的環境能讀寫：

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

少了這一層，這個 skill 會失去很大一部分恢復能力與 baseline 邏輯。這也是最直接影響輸出品質的實作細節。

提升週報與 KPI 輸出的品質

如果你想讓報告更有力，建議補齊：

• 時間範圍
• 目標對實際
• 重要成果
• 重要落差
• 根因
• 下一步行動
• 一條應該升級為預設行為的經驗

最後這一項特別符合 pro 的 evolution 模型，能讓輸出不只是回顧，而是帶有可累積的改進意義。

避開最常見的失敗模式

最常見的失敗方式，是把 pro 當成不用提供背景資訊的神奇格式化器。第二常見的問題，則是誤以為 compaction recovery 會自動生效，但實際環境根本沒有持久化本地檔案。

在第一次輸出後持續迭代

當 pro 生成報告或摘要之後，可以接著追問：

• 哪些內容應該加入 baseline
• 哪些重複行為應該升級成預設
• 還缺了哪些證據
• 哪些地方表現不佳，但不該因此降低 baseline
• 下一個 session checkpoint 應該保存什麼

這些後續問題更貼近這個 skill 的實際機制，而不只是做一般性的文字重寫。

把 pro 當成持續系統，而不是單次 prompt

pro skill 的真正價值，會在多個 session 之間慢慢顯現。如果你只用一次，你得到的多半只是格式化輸出；如果你在穩定輸入與已保存狀態的前提下反覆使用，就會得到連續性、可比較性，以及演進追蹤。

用採用者視角閱讀這個 skill

由於目前可見實作幾乎集中在 SKILL.md，建議依照以下順序閱讀：

1. trigger 清單
2. session 啟動檢查
3. compaction 狀態保護
4. 指令系統

照這個順序看，可以更快判斷 pro install 是否值得花時間，以及你的 runtime 能不能支援那些真正重要的部分。