pro

proスキルの概要

proは何に向いているか

proスキルは、tanweai/puaシステム向けの拡張レイヤーで、ワークフローの永続化、自己進化の追跡、KPI風レポート、さらに週報・述職サマリー・ランキングのようなプラットフォーム型コマンドに重点を置いています。実際のところ、proは単純な生成性能を高めるためのものではなく、セッションをまたいで文脈の連続性を保ち、アシスタントが基準・プレッシャー・進捗を「覚えている」ように振る舞わせるための仕組みです。

proが特にフィットするユーザー

proは、通常のプロンプトよりも一段構造化された運用を求めるユーザーに向いています。特に、定期レビュー、進捗管理、自己改善ログ、コンテキスト圧縮後のセッション復旧といったWorkflow Automation用途で効果を発揮します。単発の気軽な会話よりも、同じ仕事のリズムを繰り返し回している人のほうが相性は良いです。

実際に解決したい仕事

proを検討している多くのユーザーは、主に次の4つの課題を解決したいと考えています。

• 進捗ルールや運用基準をセッションをまたいで維持したい
• compactionや中断のあとも状態を失いたくない
• KPI、週報、述職サマリーのような定期的な管理系アウトプットを作りたい
• ランキングや進化追跡のような軽量なプラットフォーム機構を加えたい

こうした用途なら、proは単なる「週報を書いて」の汎用プロンプト以上に、意味のある運用ルールを加えてくれます。

proが他と違うポイント

proの最大の違いは、~/.pua/配下の状態ファイルを明示的に確認し、利用する設計になっていることです。対象には次のようなファイルが含まれます。

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

この設計により、proは単なる文体指定プロンプトではなく、状態を持つ運用レイヤーとして機能します。強みは連続性にあり、ベースラインの読み込み、compaction後の復旧、繰り返し現れる良いパターンを既定動作へ昇格させることにあります。

インストール前に知っておきたいこと

proに関するリポジトリ上の根拠は、ほぼ単一の SKILL.md に集約されています。コンセプト自体は明快ですが、その文書内で参照されている補助ファイルは、現時点のツリープレビューには出ていません。つまり、proスキルは高レベルでは把握しやすい一方で、一部の挙動はこのスキルフォルダ単体ではなく、親の pua システム側のより完全な実行環境に依存している可能性があります。

proスキルの使い方

proのインストール前提

現在確認できる範囲では、skills/pro/SKILL.md の中に専用のインストールコマンドは見当たりません。skills互換ランナーを使っている場合は、親リポジトリから導入し、利用ツール側のスキル導入構文に従って proスキルを選択してください。すでに pua を使っているなら、proは単独パッケージではなく拡張レイヤーとして扱うのが適切です。

まず読むべきファイル

最初に確認するのは次のファイルです。

• skills/pro/SKILL.md

プレビュー上で見えているファイルがこれ1つだけなので、実運用に関わるほぼすべての情報――トリガー、起動時チェック、compaction復旧、コマンドパターン――はここに書かれています。

トリガーモデルを理解する

proは、明示的なフレーズやコマンド風のパターンで起動する設計です。たとえば以下が該当します。

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

proを安定して使いたいなら、曖昧な依頼文より、こうした直接的なトリガーを優先するのがおすすめです。コマンド面が明示されているほうが、意図したワークフローに入りやすくなります。

proに必要な入力

pro skillが最も力を発揮するのは、次の情報を与えたときです。

• 欲しい出力の種類: KPI、週報、昇進・評価向けサマリー、ランキング、進化アップデート
• 対象期間: 今日、今週、今月、前四半期
• 評価の軸: 目標、指標、インシデント、成果、失敗
• 元になる材料: メモ、完了タスク、コミット、チケット、箇条書き
• 今回が新規実行か、中断後の継続か

具体的な材料がなくても体裁の整った出力は作れますが、信頼度の高いレビューを安定して作るのは難しくなります。

曖昧な依頼を強いproプロンプトに変える

弱い例:

• 「proを使ってレポートを書いて」

より良い例:

• 「週報に pro を使って。期間は月曜から金曜。入力は完了タスク6件、ブロッカー2件、未達1件、定量成果3件。インパクト、リスク、次のアクション、先週から改善した点を重視して」

ベスト:

• 「pro を週報ワークフローとして実行して。必要なら過去の状態も復元してほしい。今週を目標、デリバリー、ブロッカー、学び、来週のコミットメントで整理して。元メモはこれ: [paste bullets]。定量的な成果、1つの未達、そして今後デフォルト動作に昇格させるべきパターンを明示して」

強い依頼になるほど、proにレポートの枠組み、根拠データ、進化の判断材料を渡せるため、出力の質が上がります。

proが永続状態をどう扱うか

Workflow Automation向けに pro を使う大きな理由の1つが、この状態管理モデルです。スキル内では起動時に次のファイルを確認する想定になっています。

• ~/.pua/evolution.md：ベースラインや内在化したパターン
• ~/.pua/builder-journal.md：進行中セッション状態の復元
• ~/.pua/config.json：プラットフォーム設定の挙動

実行環境がこれらのファイルを読み書きできない場合、proが通常のプロンプトと違って見える部分の多くは失われます。

compaction保護が重要な理由

proのガイドは、compaction復旧についてかなり具体的です。compaction前には、システムが次のような実行時状態をダンプする想定です。

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

次のセッション開始時には、それらが十分新しければ再読み込みできます。長時間かつ中断を挟みやすいワークフローを回す人にとって、これはproを採用する大きな理由の1つです。

初回利用におすすめの進め方

1. SKILL.md を開き、自分の用途に合うトリガーを特定する。
2. 欲しいのがレポート系コマンドなのか、進化挙動なのか、セッション復旧なのかを決める。
3. 実行環境が本当に ~/.pua/ の永続化をサポートしているか確認する。
4. /pua:kpi や /pua:pro 周报 のような明示的な依頼から始める。
5. テーマだけでなく、構造化された根拠データを渡す。
6. 出力後、その結果をベースライン更新に使うべきか、単発の成果物として扱うべきかを見直す。

proの初回検証に向くシナリオ

pro usage の最初のテストとして相性が良いのは次のようなケースです。

• 実際のメモから週報を生成する
• 中断したセッション後にコンテキストを復旧する
• 測定可能な成果からKPIサマリーを作る
• 好ましいパターンを複数セッションで繰り返したあと、進化挙動を確認する

こうしたテストを行うと、proの状態を持つ部分が自分の環境で本当に動いているか見えやすくなります。

通常のプロンプトで十分なケース

必要なのが一度きりの整ったレポートだけなら、pro install や設定を行うより、普通のプロンプトのほうがシンプルです。proの価値が高まるのは、反復、継続性、プラットフォーム的な仕組みが重要なときです。

導入前の実用的な適合チェック

次のような要件があるなら pro の導入を検討する価値があります。

• 繰り返し使えるレポートワークフロー
• 永続化された行動ベースライン
• compactionに強いセッション継続性
• 毎回プロンプトを組み直す代わりにコマンドで呼び出したい

逆に、次を求めるなら見送ったほうがよいでしょう。

• 幅広い汎用エージェントフレームワーク
• 親システムの前提なしに完結した強い単体ドキュメント
• 状態を持たないブラウザ完結型のプロンプト体験

proスキルFAQ

proは単体スキルか、それともpuaの一部か

リポジトリ構造を見る限り、pro はより大きな pua リポジトリの一部であり、/pua コアの拡張レイヤーとして説明されています。完全に独立したシステムではなく、特化モジュールとして捉えるのが自然です。

proは初心者向きか

はい、/pua:kpi や /pua:pro 周报 のような明示的コマンド経由で使うなら初心者でも扱いやすいです。逆に、親の pua モデルやファイルベース状態管理を知らないまま、すべての運用前提を自動で推測してくれると期待するなら、向いていません。

通常のプロンプトではなくproを使う最大の理由は何か

最大の利点は継続性です。通常のプロンプトでもレポートは書けますが、pro はベースライン挙動の維持、中断された文脈の復元、そして繰り返し改善の追跡を時間をまたいで行うことを目指しています。

proの主な制約は何か

主な制約は実行環境への依存です。pro skill は、見えている単一のスキルファイルの外側にあるファイルやプロトコルを参照しています。セットアップ側がそれらをサポートしていないと、説明されている機能の一部は単なる命令追従に近い挙動まで落ちる可能性があります。

proは中国語コマンド必須か

厳密には必須ではありません。トリガーにはコマンド形式のものもあれば、排行榜 や 自进化 のような中国語フレーズも含まれています。一方で leaderboard や evolution のような英語トリガーも見られるため、コマンド面は混在していると考えておくのがよいです。

proはWorkflow Automationに役立つか

はい。定期的な週次サマリー、KPI集計、中断した作業セッション間の状態復元が必要なら、pro for Workflow Automation は十分に有力な選択肢です。単発のブレインストーミングにはそこまで強い魅力はありません。

どんなときにproを使うべきではないか

次のような場合は pro を使わないほうがよいです。

• 一度きりの整形済み出力だけが欲しい
• 利用中のエージェント環境が ~/.pua/ ファイルを永続化できない
• 依存関係がスキルフォルダ内だけで完結していてほしい
• コマンドトリガー型ワークフローよりシンプルなプロンプトを好む

proスキルを改善するには

テーマではなく根拠データを渡す

pro usage を手早く改善する最も確実な方法は、具体的な元データを渡すことです。

• 箇条書きメモ
• 指標
• 完了タスク
• ブロッカー
• Before/Afterの結果
• 下した意思決定

「良いレポートを書いて」では汎用的な文章になりがちです。「この5つの成果と2つのリスクをKPI形式で要約して」と依頼すれば、proが判断すべき材料が明確になります。

仕事に合うコマンドを正確に使う

「何かプロっぽくして」といった曖昧な頼み方は避けてください。欲しい出力に最も近いコマンドやトリガーを使うべきです。

• KPI形式のレビューなら /pua:kpi
• 週報なら /pua:pro 周报
• 昇進・評価向けの叙述なら /pua:pro 述职
• ランキングの仕組みなら /pua:pro 排行榜
• ベースライン改善の挙動なら evolution または 自进化

こうすることで曖昧さが減り、proが正しい分岐に素早く入れます。

状態永続化を実際に機能させる

proの良さを最大限引き出したいなら、実行環境が次のファイルを読み書きできることを確認してください。

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

これができないと、スキルの復旧ロジックやベースライン管理の多くが活きません。出力品質に最も大きく影響する実装上のポイントはここです。

週報とKPI出力の質を上げる

より強いレポートにしたいなら、以下を含めてください。

• 対象期間
• 目標と実績
• 目立った成果
• 目立った未達
• 根本原因
• 次のアクション
• 既定動作に昇格させるべき学びを1つ

最後の項目は、特に pro の進化モデルと相性が良く、単なる振り返り以上の価値を出しやすくなります。

よくある失敗パターンを避ける

最も多い失敗は、文脈を渡さないまま pro を魔法のフォーマッターのように扱うことです。次に多いのは、ローカルファイルを永続化しない環境なのに、compaction復旧が自動で効くと考えてしまうことです。

初回出力のあとに改善を回す

proがレポートやサマリーを生成したあと、次のように聞くと改善が進みます。

• 何をベースラインに追加すべきか
• どの繰り返し行動を既定化すべきか
• まだ不足している根拠は何か
• 出来が悪かったがベースラインは下げるべきでない点は何か
• 次回セッションのチェックポイントに何を保存すべきか

こうした追質問は、一般的なリライト依頼ではなく、このスキルの実際の仕組みに沿っています。

proを単発プロンプトではなく継続運用の仕組みとして使う

pro skill の本当の価値は、複数セッションをまたいだときに出てきます。1回だけ使うなら、得られるのは主に整形済み出力です。安定した入力と保存された状態を前提に繰り返し使うことで、継続性、比較、進化追跡が効いてきます。

導入判断の目線でスキルを読む

見えている実装が SKILL.md に集中している以上、読む順番は次の流れがおすすめです。

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

この順で確認すると、pro install に時間をかける価値があるか、そして自分のランタイムが本当に重要部分を支えられるかを短時間で判断しやすくなります。