步驟 1：把 skill-repo 放到 GitHub
工程同事或 Cursor 把這個規範庫 push 上去。你只需把網址告訴編排 Grok（它會在問卷裡問）。
先記四種「真理」放哪裡
| 在哪 | 像什麼 | 誰用 |
|---|---|---|
| GitHub：skill-repo | 公司規範手冊（有版本） | 工程師 Bot（Cursor）安裝到產品時用 |
| Google Drive：團隊資料夾 |
Grok 短規範：grok/、workflows/、roster/
|
編排與領域 Grok Bot（sync-team-drive.sh 同步）
|
| GitHub：產品專案 | 軟體（mono）+ 任務黑板 HANDOFF | Cursor 寫 code；Grok 看任務 |
| Google Sheet（每頁一表） | 各部門維護的業務數字與文案 | 部門成員改表；你看 HTML 結果 |
| HTML 報表 / 頁面 | 給 PM 驗收的網址 | 表一改、自動 build 後更新（不靠 Grok 手改） |
你跟 Grok 用一般對話即可；它跟 Cursor 用
HANDOFF 檔（含給機器用的一小段 JSON），比全程 JSON
聊天或只靠閒聊傳任務更省算力。程式規範在產品
.cursor/skills/，Cursor 自己讀。
要用 JSON 聊天嗎？（溝通怎麼最省算力）
| 誰和誰 | 用什麼 |
|---|---|
| 你 ↔ 編排 Grok | 一般對話（問清楚、確認計畫、說「同意」） |
| Grok ↔ Cursor |
HANDOFF.md + 裡面一小段給機器用的
machine: JSON
|
| 工具讀 Sheet | JSON 回傳給 Bot，不要整表貼在聊天裡 |
| 各部門同事 | 改自己的 Sheet；對人用話說或 HTML 連結 |
不必全程 JSON；也不要只靠閒聊傳任務——對話對齊意圖，HANDOFF 記已決定的事。
你可以只說一句需求；編排 Grok 仍應回你短計畫 + 一個 mini exemplar（mock 一句、一鏡分鏡、或 Sheet 行 ID 引用），你回「同意」後才派
Cursor。見 grok/task-clarify-and-plan、HANDOFF §2。
機密：勿在 Grok 對話貼 API key、密碼、未公開連結；改 env 由 Cursor 在產品 repo 設定（見 engineering 安全底線，PM 只需知道「不要貼」）。
部門 Leader 與成員怎麼溝通？
查資料可以跨部門直接問；改範圍、要別部配合、改 Sheet 契約要先經自己部門 Leader。你（PM）主要跟 各部 Leader + 編排 Grok 談決策；找成員多半是驗收或澄清細節。
| 可以橫向直問 | 查事實、看報表、對欄位名（只讀） |
|---|---|
| 要先經自己 Leader | 改別部配合、改 Sheet 契約、新功能立項、對外承諾 |
| 你（PM）主要找誰 | 各部 Leader + 編排 Grok 談決策；找成員多是驗收細節 |
完整版：team/org-communication-matrix.md（Drive
roster/，sync-team-drive.sh 會同步）。
Skill 三類：Rule / Guide / Workflow
解決 Agent「不知邊界」或「步驟漏做」：rule＝絕對不行； guide＝怎樣才算好；workflow＝先 A 再 B 的 SOP。 與「Grok 讀還是 Cursor 讀」是兩件事。
| rule | 熔斷、禁貼 code、安全底線、文案黑名單 |
|---|---|
| guide | UI 五件套、API 分層、設計審美 |
| workflow | workflows/ 社群四步、HANDOFF 派工、開發迴圈 |
完整清單與目錄對照：docs/SKILL_KIND.md、workflows/README.md（含
bot-dashboard 全頁）。在
Skill 卡片總覽：左標領域（社群），右標 skill_kind（如
workflow，與 YAML 同英文）。
維護者檢查：scripts/validate-skill-kind.sh
不是寫程式的工作（社群、影片…）誰讀？
要給對應的 Grok Bot 讀，規範在
workflows/（不是 engineering/）。寫網頁／API
仍只給 Cursor（產品 .cursor/skills/）。
索引：grok/HOW_GROK_READS_SKILLS.md · ROSTER 登記「哪個
Bot 讀哪個 workflow」 · 卡片總覽
社群審閱
bot-dashboard：介面 + skill + 工具（要三邊對齊）
bot-dashboard 是產品 repo
裡的審閱介面（HTML），不能單獨當內容線；要與
Google Sheet（資料）、skill-repo workflows（流程）、匯 CSV／build 工具（管道）一起用。Grok 總索引：
workflows/daily-community-review/。
| 層 | 放什麼 | 01／02 例子 |
|---|---|---|
| 資料 SSOT | 一頁一試算表 |
01_每日討論社群／02_每日討論AI帳號；
topic_options、final_draft、媒體 URL
|
| 回饋事件 | D1 全文 + Sheet review_log 摘要 |
/submit／/ai/submit →
review-feedback-ssot.md
|
| 介面 | bot-dashboard → bot-review | /（01）、/ai/（02）四 tab 審閱 |
| 流程 | Drive workflows/ |
daily-community-review → 選題／矩陣／反 AI 味
|
| 工具 | CSV 鏡像 + build／relay |
pages_source/google_sheets/by_page/…；改殼派
Cursor（bd-data-01／bd-data-02）
|
完整對照表（維護用 SSOT）：
workflows/daily-community-review/bot-dashboard-alignment.md
（skill × 工具 × 頁面 × Cursor skill 路徑）·
integrations/bot-dashboard/README.md
你審閱 01 單身社群帳、02 AI 帳（各 4 tab：數據→主題→畫風→定稿）。
| Tab | 你做什麼 | workflow |
|---|---|---|
| 1 數據 | 看參考 IG／Threads | social-trend-topic-mining |
| 2 主題 | 選 IG-x / TH-x | 試算表 topic_options |
| 3 畫風 | 選插畫風格 |
visual-style-selection →
_meta.default_selection_json.style
|
| 4 定稿 | 看文案、按送出回饋 |
文案 SSOT：final_draft（矩陣 + 反 AI 味 →
ready）· 你的意見： /submit →
D1（submission_id）+ 試算表
review_log 摘要，不寫進 final_draft
|
表檔名
01_每日討論社群／02_每日討論AI帳號；定稿欄位
workflows/daily-community-review/final_draft-schema.md ·
Cursor
bd-data-01-daily-community
今天驗收靠什麼（營運）
-
主戰場：bot-review 四 tab；定稿以
final_draft為 SSOT（ig_slides_json、th_body、polish_pass、draft_status）。 -
內容 HTML：試算表內容匯出 CSV →
build.py→ 正式 URL（可 CI，見 內容發布）。PM 回饋不走這條。 -
回饋（方案 A）：
GET /api/feedback再開可改；POST /submit→ D1；Grok 看review_log。規格：workflows/daily-community-review/review-feedback-ssot.md -
三邊對齊：改 Sheet 欄位要同時看
final_draft-schema.md、bot-dashboard 的bd-data-0x、與bot-dashboard-alignment.md— 避免 skill 寫一套、工具讀另一套。
其他 bot-dashboard 頁（非 01／02）
| 頁 | workflow |
|---|---|
04 團隊文件 |
team-docs-hub |
05 私藏 |
private-bookmarks |
06 晨報 |
morning-report-from-task-sheet |
07 影片 demo |
video-review-demo |
08a–08e |
video-review-gates |
09／10 證券 |
securities-daily-summary、securities-chart-audit
|
13 名冊頁 |
team-roster-dashboard |
總表：index 全頁對照 ·
workflows/README.md
我要做 X → 讀哪條 workflow？
| PM 目標 | Grok Bot | workflow / 動作 |
|---|---|---|
| 今日 01／02 社群審閱 | 社群 Bot |
daily-community-review + 子鏈（選題→矩陣→反 AI）
|
| 07 demo／08a–08e 影片關 | 影片 Bot |
video-review-demo、video-review-gates
|
| Launch 程式化 reel | 影片 Bot + 編排 |
motion-reel-launch；shotlist OK → 派 Cursor +
bundle
|
| 04／05／06／09／10／13 頁 | 幕僚／證券／Leader |
team-docs-hub、private-bookmarks、morning-report-from-task-sheet、securities-daily-summary、securities-chart-audit、team-roster-dashboard
|
| 改網頁／API／mono | 編排 Grok |
HANDOFF → Cursor（engineering/ 在產品
.cursor/skills/）
|
| 新任務、範圍不清 | 編排 Grok | task-clarify-and-plan（必含 mini exemplar） |
登記在 Drive roster/ROSTER.md「必讀 workflow」欄 · 範本
team/experts/social.md、video.md
多個產品 GitHub repo
-
一 repo 一份 HANDOFF：路徑固定
.agent_workspace/HANDOFF.md（在該產品 repo 內）。 -
編排派 Cursor 時，HANDOFF
machine應含 repo URL／分支；ROSTER「產品專案清單」填齊，避免派錯倉庫。 -
bot-dashboard是內容／審閱 mono；其他產品（例如獨立 SaaS）各管各的 HANDOFF 與預覽 URL。
速查：PM 速查「多個產品 repo」。
Mini exemplar 長什麼樣？
任務再簡，編排 Grok 也要給一個可對照切片（mock
一句、shotlist 一鏡、或 edition_id 引用 +
預期變化一句）。合格／不合格對照見 repo：
docs/examples/mini-exemplar-samples.md（工程可從 GitHub
打開；sync 後 PM 也可請編排貼摘要）
規範怎麼變？（檢討 vs 你主動改流程）
-
錯誤、熔斷、覺得 SOP 不夠用：先記在 repo
team/retros/inbox.md，不要在聊天裡改 SKILL。維護者每月檢討是否收進 skill（見docs/MAINTAINER.md）。 -
你說「從今天流程改成 …」：直接改 workflow／guide →
合併後
sync+ tag，當下生效，不必等月會。
HANDOFF 模板 §6 ·
team/retros/README.md
升級 skill-repo（新 tag）
ROSTER 釘住的 tag 變了之後，建議依序勾選（你或 Leader 執行，編排 Grok 可轉述）：
-
看
CHANGELOG.md這版改了什麼（要不要重裝 bundle）。 -
./scripts/sync-team-drive.sh "<TeamName>" "<Drive 路徑>"— 更新 Grok 的grok/、workflows/、agent_rules/。 -
每個產品 repo：若動到 engineering／frontend → 重跑
init-product-repo.sh（或 Cursor PR 同步.cursor/skills）。 -
若 CHANGELOG 寫 motion-reel-kit → 對該產品跑
install-bundle.sh motion-reel-kit … -
更新 Drive
roster/ROSTER.md的 tag 欄；跟編排說「已升到 vX.Y.Z」。
維護者完整清單：docs/MAINTAINER.md
01／02：內容發布 vs PM 回饋（兩條管線）
| 管線 | 改什麼 | 會不會重建審閱頁 |
|---|---|---|
| 內容 |
topic_options、final_draft、_meta
等 → CSV → build.py
|
會（PM 看到的文案／選題更新） |
| 回饋 |
審閱頁送出 → D1；摘要 →
review_log
|
不會（不必為回饋叫工程 deploy） |
CI 範本（只監聽內容 CSV）：
templates/github-actions/bot-dashboard-content-pages.yml.example
· 複製到 bot-dashboard 的 .github/workflows/ 後改 deploy
步驟。
一頁一 Google Sheet + HTML 給你看
第一次建團隊：你跟編排 Grok 說一句話就好
對編排 Grok 說：
「我要建新 Grok 團隊」或「第一次用 skill-repo」
它會一題一題問你（你不用事先查資料）：
- Google Drive 路徑——Mac 上雲端硬碟實際資料夾在哪（它會教你怎麼拷貝路徑）
- Grok Bot 建好了嗎——編排者、架構師是否已貼好短 prompt
- skill-repo 的 GitHub 網址——規範庫 push 上去後的連結
-
版本 tag——例如
v0.1.0，方便日後升級對照
答完後，它會幫你整理
ROSTER.md（團隊人事表），並告訴你要執行哪條同步指令。
從零到能做第一個功能（五步）
步驟 2：在 Google Drive 建團隊夾
資料夾建議叫：AI_Agent_Standard/你的團隊名。本機可用腳本
scripts/sync-team-drive.sh 生成內容，再讓 Drive
同步上去（Grok 會依你給的路徑寫指令）。
步驟 3：建立 Grok 專家 Bot
至少一個「編排者」。每個 Bot 的 System 只貼兩塊：
-
Drive 裡
roster/experts/orchestrator.md（或 architect） grok/GROK_SYSTEM_APPENDIX.md（很短，全團共用）
步驟 4：新建「產品」GitHub 專案並初始化
對編排 Grok 說：「幫我初始化 Cursor 產品專案」。它會派 Cloud Cursor
執行
init-product-repo.sh，把規則裝到正確位置：
.cursor/skills/— Cursor 寫程式時看的規範-
.cursor/rules/*.mdc— 常駐規則（例如 PM 不用看 code） .agent_workspace/HANDOFF.md— 任務黑板
套件可選：full（全棧）、web（偏網頁）、api（偏後端）。
建議（工程品質）：在 Cursor 安裝 skill-repo 內
plugins/pstack，執行 /setup-pstack。寫
src/ 時用 /poteto-mode 做自動迭代（見
pstack 與 Grok 分工）。Grok
不讀 pstack。
步驟 5：接到任務先對齊（再開工）
Grok 若聽不懂會先問你，並用幾行話列出計畫，外加 一個 mini exemplar（例如 mock 一句文案、一鏡分鏡、或 Sheet 行 ID）；你回「同意」後才派 Cursor。業務數字在 Google Sheet，你用 HTML 連結 驗收，不必在聊天裡看整張表。
步驟 6：日常只做三件事
- 你向編排 Grok說要做什麼功能
- 它更新任務黑板（HANDOFF），叫 Cloud Cursor 去寫程式、跑測試（工程師在 Cursor 內用 /poteto-mode 自動迭代到綠燈）
- 你收到：功能說明 + 測試通過紀錄 + 怎麼打開預覽（不會塞一大段程式碼）
pstack 與「自動迭代」（給工程／Cursor）
自動迭代 = 接到 HANDOFF 後，Agent
自己照步驟寫程式、跑測試、修到過再交結果。
pstack（plugins/pstack）是 Cursor
裡更完整的那套做法，入口是
/poteto-mode，不是取代 Grok。
| 誰 | 做什麼 |
|---|---|
| Grok |
澄清、計畫、HANDOFF READY_FOR_DEV；業務用
workflows/（01／02 Sheet 等）
|
| Cloud Cursor | 讀 HANDOFF → /poteto-mode + 目標與驗收 → 子步驟／測試／審查（poteto-agent） |
| 底線 |
憲法、熔斷、PM 不貼
code（pm-autonomous-execution）— 用 pstack
也不能略過
|
與 skill-repo 其他工程 skill 誰為主：
plugins/pstack/SKILL_REPO_ALIGNMENT.md
兩個 Bot 分工（一句話）
| Grok 編排者 | 像專案經理：澄清、短計畫 + mini exemplar、派工、驗收、跟你說人話 |
|---|---|
| Cloud Cursor | 像工程師：HANDOFF + /poteto-mode 自動迭代、跑測試、改狀態 |
卡住時會怎樣？（熔斷 / BLOCKED）
同一驗收指令（例如
npm test）連續三次仍失敗 → Cursor 把
HANDOFF 標 BLOCKED，寫 §4「PM 可見摘要」與 §5 技術 log
路徑。 編排 Grok 只轉述白話 A/B，不貼 stack trace。
你會收到的訊息（範本）
狀態：此功能暫停開發，需要您選一個方向後我們再繼續。
目前情況：（一句白話）
對產品的影響：（一句）
請您選擇： A. … B. … — 回覆 A 或 B 即可。
全文模板（repo）：
templates/PM_REPLY_ON_BLOCKED.md · sync 後在 Drive
agent_rules/protocols/PM_REPLY_ON_BLOCKED.md · Cursor 用
CIRCUIT_BREAKER_HANDOFF.md ·
速查熔斷段
你只需選商業方向；選完後 Grok 更新契約／HANDOFF，再派 Cursor 繼續。
寫網頁時，Cursor 多遵守「前端五件套」
你不用背名字；只要知道 UI 有專門五份規範管長相、好用、動效與載入狀態。詳見總覽頁的「前端五件套」區塊與卡片篩選「前端 UI」。
你現在可以做的下一步
- 跟編排 Grok 說：「建新 Grok 團隊」→ 完成問卷
- 書籤 PM 速查 · Skill 卡片總覽
-
工程同事：
README.md、docs/MAINTAINER.md
網頁打不開？
請不要只雙擊 html 檔（樣式可能載不入）。請任選一種方式：
-
在 Finder 雙擊本資料夾的
開啟導覽網站.command（Mac） - 終端機執行：
docs/start-docs.sh -
手動：
python3 -m http.server 8080 --directory docs，再開 http://127.0.0.1:8080/guide.html
社群子流程（嵌在 01／02 審閱裡）
你跟 Bot 用自然語言即可；驗收在 bot-review，不在聊天貼長文。
可說：「今天的 01 每日討論」「從 URL 挖角度填 topic_options」「去 AI 味再給定稿頁」。
反 AI 味：PM 快速對照
完整黑名單（含延伸詞）：
workflows/anti-ai-cliche-copywriting/SKILL.md影片（另一條線）
審閱：
video-review-demo（07）、video-review-gates（08a–08e）；總覽video-animation。程式化 reel：motion-reel-launch+ bundle。Grok 不代 render。對照 dashboard 全頁表、 Motion Reel。