無料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）。

日本語の概要は準備中です。原文の説明を表示しています。

maylogger/AGI

インストール方法を見る

含まれるファイル（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（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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 已完成；補寫章節時不要覆蓋已確認內容除非使用者要求。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

このスキルの問題を報告する

インストール

コマンドで入れる

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

ターミナルに貼り付けて実行します（Node.js が必要です）。Claude Code・Codex など、入れる先のエージェントを選べます。

エージェントに頼む

次の Agent Skill をインストールしてください。
https://github.com/maylogger/AGI/tree/master/.agents/skills/agi

まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/agi/、Codex なら ~/.agents/skills/agi/ に配置してください。

この文章をそのまま Claude Code や Codex に送ると、中身を確認してから入れてくれます。

GitHub でソースを見る

リポジトリ: maylogger/AGI
スター: 12
フォーク: 2
カテゴリ: デザイン
ライセンス: MIT
本文の言語: 中国語
最終更新: 2026年6月22日

スキルはエージェントへの指示とスクリプトの集まりです。cccskills は内容の安全性を保証していません。入れる前に中身を確認してください。