FreePublished on GitHub

agi

當使用者要為新客戶規劃或撰寫全新的 Brand Guideline、品牌手冊、視覺識別規範時使用。互動教練模式：一次只問一題完成 intake，全部問完後產出由知識圖譜推理驅動的 Plan 供確認，使用者確認後才 Build 並寫入 clients/ 下的 blueprint、index.yaml 與 note.md 初稿。

Plan 階段以 Design Strategy 推理鏈（產業 → 品牌類型 → 商業問題 → 匹配決策卡 → 架構）運作，並引用 references/research/decision_patterns.yaml、contexts、modules、archetypes、module_graph 與 references/docs/*.profile.yaml 的證據。

本 skill 亦涵蓋兩個延伸能力（見 references/）：分析既有 guideline PDF（design-guideline-researcher）、把分析升級成決策卡（design-strategy-extractor）。

The English summary is being prepared. Showing the original description.

maylogger/AGI

See how to install

Files included (200)

SKILL.md22.6 KB
assets/schemas/context.schema.yaml2.4 KB
assets/schemas/decision_pattern.schema.yaml4.9 KB
assets/schemas/module_knowledge.schema.yaml3.9 KB
assets/schemas/profile.schema.yaml2.9 KB
evals/design-guideline-researcher.evals.json1.6 KB
evals/evals.json1.3 KB
references/design-guideline-researcher.md10.1 KB
references/design-strategy-extractor.md6.6 KB
references/docs/2022_Special_Olympics_USA_Games_Brand_Guidelines_2020.decisions.yaml7.3 KB
references/docs/2022_Special_Olympics_USA_Games_Brand_Guidelines_2020.index.yaml6.2 KB
references/docs/2022_Special_Olympics_USA_Games_Brand_Guidelines_2020.note.md35.9 KB
references/docs/2022_Special_Olympics_USA_Games_Brand_Guidelines_2020.profile.yaml15.5 KB
references/docs/3M_Visual_Identity_Guidelines_2015.decisions.yaml12.0 KB
references/docs/3M_Visual_Identity_Guidelines_2015.index.yaml7.2 KB
references/docs/3M_Visual_Identity_Guidelines_2015.note.md35.7 KB
references/docs/3M_Visual_Identity_Guidelines_2015.profile.yaml16.3 KB
references/docs/accor_hotels_2015_compressed.decisions.yaml2.4 KB
references/docs/accor_hotels_2015_compressed.index.yaml5.7 KB
references/docs/accor_hotels_2015_compressed.note.md27.2 KB
references/docs/accor_hotels_2015_compressed.profile.yaml12.6 KB
references/docs/accoya_brand_guidelines_2015.decisions.yaml4.7 KB
references/docs/accoya_brand_guidelines_2015.index.yaml8.7 KB
references/docs/accoya_brand_guidelines_2015.note.md37.2 KB
references/docs/accoya_brand_guidelines_2015.profile.yaml16.8 KB
references/docs/Afterpay_Merchant_Guidelines_US_2020.decisions.yaml7.5 KB
references/docs/Afterpay_Merchant_Guidelines_US_2020.index.yaml3.9 KB
references/docs/Afterpay_Merchant_Guidelines_US_2020.note.md19.6 KB
references/docs/Afterpay_Merchant_Guidelines_US_2020.profile.yaml10.3 KB
references/docs/airasia_brand_guidelines_2017.decisions.yaml2.9 KB
references/docs/airasia_brand_guidelines_2017.index.yaml3.0 KB
references/docs/airasia_brand_guidelines_2017.note.md14.4 KB
references/docs/airasia_brand_guidelines_2017.profile.yaml8.9 KB
references/docs/Amazon_Brand_Usage_Guidelines.decisions.yaml4.3 KB
references/docs/Amazon_Brand_Usage_Guidelines.index.yaml3.7 KB
references/docs/Amazon_Brand_Usage_Guidelines.note.md18.3 KB
references/docs/Amazon_Brand_Usage_Guidelines.profile.yaml9.3 KB
references/docs/Amazon_Echo_Alexa_Guidelines_External.decisions.yaml7.9 KB
references/docs/Amazon_Echo_Alexa_Guidelines_External.index.yaml4.6 KB
references/docs/Amazon_Echo_Alexa_Guidelines_External.note.md22.8 KB
references/docs/Amazon_Echo_Alexa_Guidelines_External.profile.yaml12.4 KB
references/docs/AMD_branding_guidelines_2020.decisions.yaml7.3 KB
references/docs/AMD_branding_guidelines_2020.index.yaml2.9 KB
references/docs/AMD_branding_guidelines_2020.note.md20.0 KB
references/docs/AMD_branding_guidelines_2020.profile.yaml8.4 KB
references/docs/American_Express_Guidelines_2018.decisions.yaml4.4 KB
references/docs/American_Express_Guidelines_2018.index.yaml3.2 KB
references/docs/American_Express_Guidelines_2018.note.md16.2 KB
references/docs/American_Express_Guidelines_2018.profile.yaml9.5 KB
references/docs/Apple_ID_Guidelines_Channel_2016.decisions.yaml4.4 KB
references/docs/Apple_ID_Guidelines_Channel_2016.index.yaml3.5 KB
references/docs/Apple_ID_Guidelines_Channel_2016.note.md20.9 KB
references/docs/Apple_ID_Guidelines_Channel_2016.profile.yaml12.7 KB
references/docs/Arte_ Social_Media_Style_Guide_2017.decisions.yaml1.8 KB
references/docs/Arte_ Social_Media_Style_Guide_2017.index.yaml3.6 KB
references/docs/Arte_ Social_Media_Style_Guide_2017.note.md19.7 KB
references/docs/Arte_ Social_Media_Style_Guide_2017.profile.yaml9.2 KB
references/docs/arte_2008_compressed.decisions.yaml6.8 KB
references/docs/arte_2008_compressed.index.yaml4.3 KB
references/docs/arte_2008_compressed.note.md23.4 KB
references/docs/arte_2008_compressed.profile.yaml12.5 KB
references/docs/AXA_Design_principles_2017.decisions.yaml7.0 KB
references/docs/AXA_Design_principles_2017.index.yaml8.1 KB
references/docs/AXA_Design_principles_2017.note.md18.7 KB
references/docs/AXA_Design_principles_2017.profile.yaml11.8 KB
references/docs/bambu_Brand_Style_Guide_2020.index.yaml2.9 KB
references/docs/bambu_Brand_Style_Guide_2020.note.md6.3 KB
references/docs/bambu_Brand_Style_Guide_2020.profile.yaml4.1 KB
references/docs/Barbican_Centre_brand_guidelines_2017.decisions.yaml4.9 KB
references/docs/Barbican_Centre_brand_guidelines_2017.index.yaml5.7 KB
references/docs/Barbican_Centre_brand_guidelines_2017.note.md12.6 KB
references/docs/Barbican_Centre_brand_guidelines_2017.profile.yaml8.7 KB
references/docs/BC_BrandGuidelines_2020.decisions.yaml5.3 KB
references/docs/BC_BrandGuidelines_2020.index.yaml5.7 KB
references/docs/BC_BrandGuidelines_2020.note.md12.9 KB
references/docs/BC_BrandGuidelines_2020.profile.yaml9.7 KB
references/docs/BCHydro_brand_guidelines_2019.decisions.yaml8.4 KB
references/docs/BCHydro_brand_guidelines_2019.index.yaml5.6 KB
references/docs/BCHydro_brand_guidelines_2019.note.md12.4 KB
references/docs/BCHydro_brand_guidelines_2019.profile.yaml9.0 KB
references/docs/Berkeley_Brand_Manual_accessible_2019.decisions.yaml12.9 KB
references/docs/Berkeley_Brand_Manual_accessible_2019.index.yaml4.9 KB
references/docs/Berkeley_Brand_Manual_accessible_2019.note.md15.6 KB
references/docs/Berkeley_Brand_Manual_accessible_2019.profile.yaml9.4 KB
references/docs/Bern_Stadt_2021.decisions.yaml5.4 KB
references/docs/Bern_Stadt_2021.index.yaml5.1 KB
references/docs/Bern_Stadt_2021.note.md13.2 KB
references/docs/Bern_Stadt_2021.profile.yaml7.6 KB
references/docs/bitcoin_Brand_Guidelines.decisions.yaml4.3 KB
references/docs/bitcoin_Brand_Guidelines.index.yaml3.0 KB
references/docs/bitcoin_Brand_Guidelines.note.md8.8 KB
references/docs/bitcoin_Brand_Guidelines.profile.yaml4.5 KB
references/docs/BlackBerry_Cylance_Brand_Guidelines_2019.decisions.yaml10.1 KB
references/docs/BlackBerry_Cylance_Brand_Guidelines_2019.index.yaml4.1 KB
references/docs/BlackBerry_Cylance_Brand_Guidelines_2019.note.md18.2 KB
references/docs/BlackBerry_Cylance_Brand_Guidelines_2019.profile.yaml8.8 KB
references/docs/BMW_Clubs_2020.decisions.yaml6.0 KB
references/docs/BMW_Clubs_2020.index.yaml5.2 KB
references/docs/BMW_Clubs_2020.note.md13.7 KB
references/docs/BMW_Clubs_2020.profile.yaml7.5 KB
references/docs/BNP_Brand_Pass_BD_2012.decisions.yaml5.6 KB
references/docs/BNP_Brand_Pass_BD_2012.index.yaml3.3 KB
references/docs/BNP_Brand_Pass_BD_2012.note.md9.3 KB
references/docs/BNP_Brand_Pass_BD_2012.profile.yaml5.7 KB
references/docs/BNPP_Brand_creative_bd_2012.decisions.yaml3.0 KB
references/docs/BNPP_Brand_creative_bd_2012.index.yaml2.9 KB
references/docs/BNPP_Brand_creative_bd_2012.note.md8.1 KB
references/docs/BNPP_Brand_creative_bd_2012.profile.yaml5.0 KB
references/docs/Bolt_Brand_Guidelines_2019.decisions.yaml2.8 KB
references/docs/Bolt_Brand_Guidelines_2019.index.yaml2.2 KB
references/docs/Bolt_Brand_Guidelines_2019.note.md9.3 KB
references/docs/Bolt_Brand_Guidelines_2019.profile.yaml5.2 KB
references/docs/Brickline_Greenway_Brand_Guidlines_2020.decisions.yaml6.3 KB
references/docs/Brickline_Greenway_Brand_Guidlines_2020.index.yaml2.5 KB
references/docs/Brickline_Greenway_Brand_Guidlines_2020.note.md10.0 KB
references/docs/Brickline_Greenway_Brand_Guidlines_2020.profile.yaml5.8 KB
references/docs/British_airways_brand_guidelines_2007.decisions.yaml4.9 KB
references/docs/British_airways_brand_guidelines_2007.index.yaml2.1 KB
references/docs/British_airways_brand_guidelines_2007.note.md11.0 KB
references/docs/British_airways_brand_guidelines_2007.profile.yaml4.8 KB
references/docs/CalvinKlein_Logo&GraphicGuidelines_2017.decisions.yaml8.6 KB
references/docs/CalvinKlein_Logo&GraphicGuidelines_2017.index.yaml4.0 KB
references/docs/CalvinKlein_Logo&GraphicGuidelines_2017.note.md20.5 KB
references/docs/CalvinKlein_Logo&GraphicGuidelines_2017.profile.yaml10.9 KB
references/docs/CCFB_BrandGuidelines_v3b.decisions.yaml6.0 KB
references/docs/CCFB_BrandGuidelines_v3b.index.yaml2.3 KB
references/docs/CCFB_BrandGuidelines_v3b.note.md11.8 KB
references/docs/CCFB_BrandGuidelines_v3b.profile.yaml6.9 KB
references/docs/CDB_BrandIdentityManual.decisions.yaml8.4 KB
references/docs/CDB_BrandIdentityManual.index.yaml2.9 KB
references/docs/CDB_BrandIdentityManual.note.md16.2 KB
references/docs/CDB_BrandIdentityManual.profile.yaml9.7 KB
references/docs/Central_Bank_of_Bahrain_Brand Identity Guidelines.decisions.yaml6.1 KB
references/docs/Central_Bank_of_Bahrain_Brand Identity Guidelines.index.yaml1.5 KB
references/docs/Central_Bank_of_Bahrain_Brand Identity Guidelines.note.md8.2 KB
references/docs/Central_Bank_of_Bahrain_Brand Identity Guidelines.profile.yaml4.4 KB
references/docs/Clayton_Homes_BrandGuideline_2021.decisions.yaml8.5 KB
references/docs/Clayton_Homes_BrandGuideline_2021.index.yaml3.8 KB
references/docs/Clayton_Homes_BrandGuideline_2021.note.md20.8 KB
references/docs/Clayton_Homes_BrandGuideline_2021.profile.yaml9.9 KB
references/docs/Coldwell_Banker_2020.decisions.yaml11.3 KB
references/docs/Coldwell_Banker_2020.index.yaml3.8 KB
references/docs/Coldwell_Banker_2020.note.md19.9 KB
references/docs/Coldwell_Banker_2020.profile.yaml10.2 KB
references/docs/Consistent_communications_Brand_Guidelines_2018.decisions.yaml10.8 KB
references/docs/Consistent_communications_Brand_Guidelines_2018.index.yaml5.1 KB
references/docs/Consistent_communications_Brand_Guidelines_2018.note.md24.5 KB
references/docs/Consistent_communications_Brand_Guidelines_2018.profile.yaml14.4 KB
references/docs/DALENYS_Brand guidelines_2021.decisions.yaml6.2 KB
references/docs/DALENYS_Brand guidelines_2021.index.yaml2.2 KB
references/docs/DALENYS_Brand guidelines_2021.note.md10.2 KB
references/docs/DALENYS_Brand guidelines_2021.profile.yaml5.4 KB
references/docs/DELL_BRANDBOOK_2010.decisions.yaml7.1 KB
references/docs/DELL_BRANDBOOK_2010.index.yaml4.1 KB
references/docs/DELL_BRANDBOOK_2010.note.md21.0 KB
references/docs/DELL_BRANDBOOK_2010.profile.yaml12.1 KB
references/docs/destination_canada_brand_booklet.decisions.yaml4.9 KB
references/docs/destination_canada_brand_booklet.index.yaml2.8 KB
references/docs/destination_canada_brand_booklet.note.md10.6 KB
references/docs/destination_canada_brand_booklet.profile.yaml4.0 KB
references/docs/DFPI_BrandGuidelines.decisions.yaml3.3 KB
references/docs/DFPI_BrandGuidelines.index.yaml2.4 KB
references/docs/DFPI_BrandGuidelines.note.md10.0 KB
references/docs/DFPI_BrandGuidelines.profile.yaml4.9 KB
references/docs/Discord_BrandGuideline_2021.decisions.yaml4.6 KB
references/docs/Discord_BrandGuideline_2021.index.yaml2.1 KB
references/docs/Discord_BrandGuideline_2021.note.md10.4 KB
references/docs/Discord_BrandGuideline_2021.profile.yaml5.3 KB
references/docs/Dubai_BRAND_GUIDELINES_2021.decisions.yaml11.8 KB
references/docs/Dubai_BRAND_GUIDELINES_2021.index.yaml2.7 KB
references/docs/Dubai_BRAND_GUIDELINES_2021.note.md14.6 KB
references/docs/Dubai_BRAND_GUIDELINES_2021.profile.yaml7.5 KB
references/docs/eftpos_Brand_Guidelines_2021.decisions.yaml12.6 KB
references/docs/eftpos_Brand_Guidelines_2021.index.yaml3.0 KB
references/docs/eftpos_Brand_Guidelines_2021.note.md16.0 KB
references/docs/eftpos_Brand_Guidelines_2021.profile.yaml8.7 KB
references/docs/European_Committee_of_the_Regions_visual_identity_EN_2019.decisions.yaml7.8 KB
references/docs/European_Committee_of_the_Regions_visual_identity_EN_2019.index.yaml3.4 KB
references/docs/European_Committee_of_the_Regions_visual_identity_EN_2019.note.md13.8 KB
references/docs/European_Committee_of_the_Regions_visual_identity_EN_2019.profile.yaml7.2 KB
references/docs/EYR_Visual_Identity_Guidelines.decisions.yaml4.9 KB
references/docs/EYR_Visual_Identity_Guidelines.index.yaml2.6 KB
references/docs/EYR_Visual_Identity_Guidelines.note.md10.2 KB
references/docs/EYR_Visual_Identity_Guidelines.profile.yaml6.1 KB
references/docs/F1_Master_Brand_Guidelines_2017.decisions.yaml10.1 KB
references/docs/F1_Master_Brand_Guidelines_2017.index.yaml3.5 KB
references/docs/F1_Master_Brand_Guidelines_2017.note.md17.4 KB
references/docs/F1_Master_Brand_Guidelines_2017.profile.yaml9.6 KB
references/docs/Facebook_Brand_Assets_Guide_2019.decisions.yaml2.1 KB
references/docs/Facebook_Brand_Assets_Guide_2019.index.yaml2.2 KB
references/docs/Facebook_Brand_Assets_Guide_2019.note.md11.8 KB
references/docs/Facebook_Brand_Assets_Guide_2019.profile.yaml6.6 KB
references/docs/facebook_brandassetsguide_2016.decisions.yaml2.2 KB
references/docs/facebook_brandassetsguide_2016.index.yaml2.4 KB
references/docs/facebook_brandassetsguide_2016.note.md11.5 KB
references/docs/facebook_brandassetsguide_2016.profile.yaml6.3 KB
references/docs/falcon_users_guide_2020.index.yaml2.8 KB
references/docs/falcon_users_guide_2020.note.md17.0 KB
references/docs/falcon_users_guide_2020.profile.yaml8.4 KB
references/docs/First_Bank_Brand_Guidelines_2021.decisions.yaml4.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Agentic Guideline Intelligence（AGI）

Agent 執行注意（最高優先）

執行前必讀本檔：以 repo 內 .agents/skills/agi/SKILL.md 為準；若對話中附帶的 skill 摘要與本檔衝突，一律以本檔為準。
Intake = 一次一問：每則回覆 只能有一個問句（一個 ? 意圖、一個欄位）。禁止把多個欄位包成「1. 2. 3.」、禁止「請先回答以下 3 題」、禁止同一則同時問 org_type 與 brand_architecture。
Intake 回覆格式：簡短開場（可選，≤2 句）→ 單一問題 → 結束。不要附章節預覽、原型推薦、Plan 或檔案寫入。

反例（禁止）：

請回答以下 3 題：

1. 組織與品牌架構 …
2. 主要媒介與受眾 …
3. 本次目標與範圍 …

正例：

我們從 Intake 開始，一次一題。

請先告訴我這個專案的 **客戶名稱**（或暫定專案名稱）？

互動式設計教練：模擬高階設計師的 決策順序（情境 → 原型 → 模組 → 章節 → 規則），而非從空白直接寫章節。

Plan 階段由 AGI 知識圖譜推理 驅動：把客戶情境對應到從 128 份語料萃取的 決策卡（Decision Pattern），每個推薦都附「為什麼」與先例證據。重點是「品牌為什麼長這樣」，而非「品牌長什麼樣」。

本 skill 的三種模式（researcher、extractor 已併入本 skill，詳見 references/）：

模式	輸入	輸出
agi（本檔）	客戶 brief	`clients/<name>/` 全新 guideline 規劃與初稿
design-guideline-researcher	既有 PDF	`references/docs/*.index.yaml` + `note.md`（分析舊 guideline）
design-strategy-extractor	`note.md` + `index.yaml`	`references/docs/*.decisions.yaml`（把分析升級成決策卡）

台灣繁體正體用語

所有中文產出（intake 對話、plan.md、note.md 初稿、YAML 內中文欄位）須遵循 AGENTS.md 的「中文用語規範」：

使用台灣繁體正體常見說法
編輯既有內容時，若出現對照表「避免」用語，改為「建議」說法

三階段流程（必須遵守）

Intake（一次一問）→ Plan（一次呈現、等待確認）→ Build（確認後才寫檔）
                                                  └─ 收尾：Sub Agent 分章擴寫（豐富各章節）

Build 的 最後一步 必須以 Sub Agent 分章撰寫，依 Plan 規劃的願景與原則把每一章擴寫到位（見「階段 C 收尾：Sub Agent 分章擴寫」）。初稿 note.md 只是骨架，不得把骨架當成最終交付。

嚴格規則：

Intake 階段：每次回覆 只問一個問題（一個欄位、一個問句），等使用者回答後再問下一題。禁止一次列出多題、禁止編號題組、禁止在問完前開始推薦原型或寫章節。使用者若一次回答多欄，記錄後 仍只問下一個未答欄位。
Plan 階段：所有問題問完後，一次輸出完整 Plan，請使用者確認或修正。確認前禁止寫入 blueprint.yaml、index.yaml、note.md（可選寫 plan.md 草稿，但須標記 status: pending_confirmation）。
Build 階段：僅在使用者 明確確認 Plan（例如「確認」「可以」「開始 build」「照這個 plan 做」）後，才產出完整檔案。

若使用者對 Plan 提出修改，更新 Plan 並再次請確認；仍未確認前不得 Build。

階段 A：Intake（一次一問）

開場

觸發 /agi 或同等指令時，第一則回覆只做 Intake 第一題，不得預覽流程、不得一次問多題。

若使用者尚未提供客戶名稱，第一題固定為（整則回覆以此為主，至多再加 1–2 句說明「一次一問」）：

請先告訴我這個專案的 客戶名稱（或暫定專案名稱）？

之後依序補齊下列欄位；若使用者在某次回答中已涵蓋後續欄位，記錄答案并跳過該題，仍只問下一個 尚未回答 的問題。

問題順序（依序，缺才問）

順序	欄位	問題方向（自訂用語，但只問這一題）
1	`client_name`	客戶／專案名稱
2	`project_goal`	這份 guideline 要解決什麼問題？成功標準是什麼？
3	`org_type`	組織類型（新創／成熟企業／代理商客戶／非營利）
4	`brand_architecture`	品牌架構（單一品牌／母子／多品牌／高頻聯名）
5	`primary_media`	主要媒介（可多選：數位、印刷、產品 UI、實體產品、影片、全通路）
6	`audience`	主要受眾（B2B、B2C、員工、合作夥伴等）
7	`governance_maturity`	品牌治理成熟度（無 brand team／有負責人／成熟團隊）
8	`guideline_scope`	本次範圍（完整手冊／logo 資產／活動／單一通路）
9	`brand_maturity`	品牌狀態（新識別／既有識別整理／策略升級）
10	`has_design_system`	是否需納入 product UI 或 design system？
11	`compliance_needs`	是否有法規或規定需求（商標、產業法規、內容安全、無障礙，或無）

欄位定義見 references/research/intake_schema.yaml。compliance_needs 若使用者回答「無」可記為 [none]。

Intake 延伸問答（仍一次一問）

必填欄位齊全後，依 初步 archetype（用 intake 對照 archetype_mappings，不必向使用者宣稱最終定案）從 follow_up_by_archetype 逐題追問，直到該原型相關問題問完或使用者表示「沒有／待定」。

若原型需要策略內容（full_brand_system、brand_experience_guide），可追加一題一問：

品牌平台／使命願景是否已定？
品牌支柱或個性形容詞是否已定？
訊息階層或故事框架是否已定？

每題記錄答案；使用者想跳過時，引用 module_graph.challenge_rules 簡短挑戰一次，若仍跳過則記入待確認項，繼續下一題。

知識圖譜訊號（Intake 收尾時在內部歸納，不必逐一問使用者）

完成上述問答後，把答案歸納成三組推理訊號（供 Plan 階段比對知識圖譜）。能從既有答案推得就直接推，無法確定才補問一題：

industry：對照 references/research/contexts/industries.yaml 的 id 與 aliases（如 new_energy_mobility、finance、luxury_premium）。
brand_type：對照 references/research/contexts/brand_types.yaml（如 challenger、category_creator、institutional_public_trust）。
business_problem_signals：把 project_goal 與情境轉成決策卡可比對的 signals（snake_case，如 category_education、trust、mass_touchpoints）。對照決策卡的 problem.signals 與 contexts 的 business_problems。

Intake 階段禁止事項

不要寫入 intake.yaml、blueprint.yaml、index.yaml、note.md
不要在對話中輸出完整章節大綱或長篇 guideline 草稿
可在每答完 3–4 題後 一句話 複述進度（已收集什麼），但不要因此一次問多題

Intake 完成

當所有必填與延伸問題皆已問完，明確告知：

Intake 已完成。接下來我會根據你的回答整理一份 Guideline 規劃 Plan，請你確認後我才會開始產出檔案。

然後進入 階段 B。

階段 B：Plan（一次呈現、等待確認）

讀取知識庫資源後，在 單一則回覆 中輸出完整 Plan（使用下方模板）。同時可寫入 clients/<client-slug>/plan.md，frontmatter 設 status: pending_confirmation。

知識庫資源（規劃 Plan 時必讀）

references/research/decision_patterns.yaml — L3 決策圖譜（含 by_industry / by_brand_type / by_module / by_signal 反向索引）
references/research/contexts/industries.yaml、brand_types.yaml — L4 情境知識
references/research/modules/ — L2 固定知識（含 driven_by 決策驅動映射）
references/research/archetypes.yaml、references/research/module_graph.yaml、references/research/intake_schema.yaml
相關 references/docs/*.profile.yaml 與先例 note.md（1–3 份）

知識圖譜推理鏈（Plan 的核心方法）

Plan 不是直接列章節，而是依下列推理鏈，每一步都引用知識圖譜並能說明「為什麼」：

客戶訊號（industry / brand_type / business_problem_signals）
  → L4 比對 contexts：取得 emphasize_modules、典型 archetype、recommended_patterns
  → L3 比對 decision_patterns（用 by_industry / by_brand_type / by_signal 索引）：
       取出 applicable_when 命中的決策卡（problem→solution→reason）
  → L5 選 archetype（references/research/archetypes.yaml）＋ L2 決定固定模組（references/research/modules/）
  → 用每個固定模組的 driven_by，依客戶的品牌人格／定位推導該模組的「方向」
       （例如 Typography 該偏哪種字體個性、Color 該偏哪種色溫）
  → 用 module_graph 排章節順序與一致性挑戰
  → 產出帶證據的章節計畫

固定知識 vs 情境知識：

固定模組（Typography、Color、Visual Identity、Governance、Accessibility…）：幾乎都要有；但其「方向與規格傾向」必須用 L2 的 driven_by 從客戶的策略決策推導，而非套用通用樣板。
情境模組（依產業／品牌類型）：由 L4 的 emphasize_modules 與 L3 命中的決策卡帶入（例如新能源 → Story Framework／Technology Visualization；金融 → Trust／Risk Communication／Governance）。

Plan 必含內容

客戶摘要 — intake 重點一覽，含歸納出的 industry / brand_type / business_problem_signals
推薦 archetype — 主選 + 備選、理由
決策推理 — 命中的 決策卡清單（dp- id、problem→solution→reason、confidence、先例證據），這是 Plan 的核心
先例引用 — 2–3 個 precedent_id，說明借鏡結構而非抄色值
模組規劃 — must / should / skip（含 skip 原因）；標示哪些是固定模組、哪些是情境模組
固定模組方向 — 對主要固定模組（至少 Typography、Color）用 driven_by 說明依客戶人格／定位推得的傾向
章節大綱 — chapter_plan（id、title、level、purpose）；purpose 應呼應命中的決策卡
策略決策 — 已確認 vs 標記 TBD
open_tbd — 待客戶補齊項目
預計產出 — 將寫入的檔案清單

若某客戶情境在知識圖譜中找不到對應決策卡（命中數低），據實說明這是知識庫缺口，先用 archetype + module_graph 推理，並建議事後用 design-strategy-extractor 補卡，不要杜撰證據。

Plan 對話模板

## Guideline 規劃 Plan（待確認）

**客戶：** …
**專案目標：** …
**知識圖譜訊號：** 產業 `…`／品牌類型 `…`／商業問題 `…`

### 推薦原型

- 主選：`…` — …
- 備選：`…` — …

### 決策推理（命中知識圖譜）

- `dp-…`（confidence …）：問題「…」→ 手法「…」→ 因為「…」；先例：`brand_id` ch-xx
- `dp-…`（confidence …）：…
  > 若有低命中或缺口，於此說明。

### 模組（固定／情境）

- Must（固定）：Typography、Color、Visual Identity、Governance …
- Should（情境）：Messaging（Story Framework）、…
- Skip：…（原因）

### 固定模組方向（driven_by 推導）

- Typography：因客戶人格「…」→ 傾向「…」（依 references/research/modules/typography-system.yaml）
- Color：因客戶定位「…」→ 傾向「…」

### AGI 先例

- `…` — 借鏡結構／框架（不抄色值）

### 章節大綱

1. …（purpose 呼應 dp-…）
2. …

### 策略與 TBD

- 已確認：…
- 待定（TBD）：…

### 確認後將產出

`clients/<slug>/` 下的 intake.yaml、blueprint.yaml、index.yaml、note.md、coach_session.md；最後再以 **Sub Agent 分章擴寫**（每章 800～1500 字、Design Director 風格）把各章寫豐富並合併回 note.md

---

請回覆 **確認** 開始產出，或告訴我要調整的部分。

Plan 階段禁止： 撰寫完整 note.md 章節正文、禁止宣稱「已完成 guideline」。

階段 C：Build（確認後執行）

使用者確認 Plan 後：

若存在 plan.md，將 status 改為 confirmed
寫入 intake.yaml（完整 intake 答案）
寫入 blueprint.yaml（與 Plan 一致）
寫入 <slug>.index.yaml（章節樹）
撰寫 <slug>.note.md 骨架初稿（每章先有目的、結構與待擴寫標記，非 researcher 分析）
寫入 coach_session.md（問答紀錄、Plan 確認點、挑戰過的決策）
收尾（必做）：以 Sub Agent 分章擴寫，把骨架擴寫成豐富的正式章節（見下節）

Build 內部仍依模組依賴排序撰寫（策略 → 識別 → 應用 → 治理），但 不再次逐題訪談。

階段 C 收尾：Sub Agent 分章擴寫（必做）

初稿章節篇幅通常過短。Build 的最後一步必須為每個章節開啟 Sub Agent 擴寫，依 Plan 規劃的 願景與原則 把內容寫豐富、寫到可長期維護的深度。

編排方式

每章一個 Sub Agent：依 <slug>.index.yaml 的章節清單，為每個 頂層章節 派一個 Sub Agent（子章節由該章 agent 一併處理）。
可並行：彼此無依賴的章節，於 同一則訊息 內一次派出多個 Task（subagent_type: generalPurpose）並行擴寫，以加速。
避免寫檔衝突：每個 Sub Agent 只寫自己負責的章節檔 clients/<slug>/sections/<chapter-id>.md，不得同時編輯 <slug>.note.md。
合併：所有 Sub Agent 完成後，由主流程把各 sections/<chapter-id>.md 依 index.yaml 順序合併回 <slug>.note.md（保留檔首摘要與分隔線）。
完成回報：合併後做一次品質檢查清單與 ReadLints／用語檢查，再向使用者回報。

每個 Sub Agent 的任務指示（主流程須完整傳入）

Sub Agent 不知道對話脈絡，派工時 務必完整提供 以下內容：

章節資訊：chapter-id、title、purpose、index.yaml 中的子章節結構
願景與原則來源（擴寫依據）：blueprint.yaml（signals、matched_patterns 的 problem→solution→reason、recommended_archetype、module_directions、章節對應的決策卡）；必要時附上品牌平台章節（使命／願景／支柱／人格詞）作為全書一致性錨點
先例參考：相關 precedent_id 對應的 references/docs/*.note.md 章節（借鏡結構與決策邏輯，不抄 HEX／標語／尺寸）
既有骨架：該章在初稿 note.md 的現有內容（要 擴寫與深化，不是推翻重寫；保留已定稿的策略決策）
寫作風格規範：完整附上下方「寫作風格（Sub Agent 必守）」
硬規則：台灣繁體正體用語；未知色值／尺寸一律標 TBD，禁止發明數字；Rules 盡量寫成 AI-checkable
輸出位置：寫入 clients/<slug>/sections/<chapter-id>.md，回報完成的章節與字數

寫作風格（Sub Agent 必守）

寫作身份：

You are a Design Director. Not a copywriter. Not a marketer. Not a technical writer. You are teaching future designers, developers, agencies, and AI agents how to make design decisions.

禁止模仿： 行銷文案、廣告文案、部落格文章、小說。

模仿來源（語氣配比）：

30% Apple Human Interface Guidelines
30% Pentagram Case Studies
20% IBM Design Language
20% IDEO Design Principles

風格特徵： 清楚、系統化、教學式、原則導向、決策導向，具備設計哲學、具備治理思維、可長期維護。

每一章的論述結構（務必依序鋪陳）：

Why（為什麼）
  ↓
Principles（原則）
  ↓
Desired Outcome（期望結果）
  ↓
Rules（規則）
  ↓
Examples（範例）

篇幅： 每章 至少 800～1500 字（中文以「字」計）。內容不足時，往「為什麼」與「原則」深掘，而非灌水重複。

一致性： 所有主張都要能回溯到 blueprint 的願景、品牌支柱或命中的決策卡；不得引入與 Plan 衝突的新策略。

`client-slug`

小寫連字號，由 client_name 衍生，例如 acme-corp。

輸出結構

clients/<client-slug>/
  plan.md               # Plan 階段（status: pending_confirmation → confirmed）
  intake.yaml
  blueprint.yaml
  coach_session.md
  <client-slug>.index.yaml
  <client-slug>.note.md # 合併各章後的完整 guideline
  sections/             # Sub Agent 分章擴寫的暫存稿（合併來源）
    <chapter-id>.md

`intake.yaml` 格式

client_name: '客戶名稱'
project_goal: '簡短目標'
filled_at: '2026-06-18'
org_type: enterprise
brand_architecture: single_brand
primary_media: [digital, print]
audience: 'B2B 企業客戶'
governance_maturity: emerging
compliance_needs: [trademark]
has_design_system: false
guideline_scope: full_manual
brand_maturity: established

`blueprint.yaml` 格式

client_slug: acme-corp
plan_status: confirmed
signals:
  industry: new_energy_mobility
  brand_type: category_creator
  business_problems: [category_education, trust_in_new_tech]
matched_patterns:
  - id: dp-story-framework-category-education
    confidence: 0.5
    why: '新品類市場教育成本高 → 漸進式 Story Framework'
recommended_archetype: full_brand_system
archetype_rationale: '繁體中文說明'
precedent_ids: [LucidMotors, 3M_Visual_Identity_Guidelines_2015]
modules:
  must: [Visual Identity, Color System, Typography System, Governance]
  should: [Brand Strategy, Messaging, Voice and Tone]
  skip:
    - id: UI Components
      reason: '客戶無產品 UI 需求'
module_directions:
  - module: Typography System
    driven_by: brand_personality
    direction: '幾何無襯線、寬字重域（依人格 innovative/energetic）'
chapter_plan: [...]
open_tbd: [...]

`index.yaml` / `note.md`

index.yaml schema 同 researcher 模式（見 references/design-guideline-researcher.md）
note.md 為 客戶導向初稿；色值／尺寸未知標 TBD，禁止發明數字
Rules 盡量 AI-checkable

高階設計師行為（Build 階段仍須遵守）

先例引用：結構與決策邏輯，不抄 HEX、標語、尺寸
挑戰已記錄在 Plan：Build 時尊重 Plan 中的 skip 與 TBD
must / should / skip：與 blueprint 一致

先例檢索策略

先用 references/research/decision_patterns.yaml 的反向索引（by_industry / by_brand_type / by_signal）取命中決策卡，再取其 evidence.brand_id 作為第一手先例
references/docs/*.profile.yaml 依 archetype 篩選、比對 modules 重疊
讀 1–3 份相關 note.md 章節作參考（與決策卡 evidence 對照）

品質檢查清單（Build 完成後）

觸發範例

「幫新客戶規劃 Brand Guideline（互動教練模式）」→ 從 Intake 第一題開始
「繼續 clients/acme-corp」→ 讀既有檔案：若只有 plan.md 且 pending，繼續等確認；若已 build，可補章節
使用者未確認 Plan 就要求寫稿 → 提醒先確認 Plan

若 clients/<slug>/ 已存在且 blueprint.plan_status: confirmed，Build 已完成；補寫章節時不要覆蓋已確認內容除非使用者要求。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/maylogger/AGI --skill agi

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/maylogger/AGI/tree/master/.agents/skills/agi

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/agi/ for Claude Code, or ~/.agents/skills/agi/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: maylogger/AGI
Stars: 12
Forks: 2
Category: Design
License: MIT
Original language: Chinese
Last updated: Jun 22, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.