手把手教你利用Claude Code Skills 生成售前方案

作者：架構師煉丹爐
日期：2026年1月31日 上午5:15
來源：WeChat 原文

✦整理版優先睇

速讀 5 個重點 高亮

學習利用 Claude Code Skills 構建自定義技能，實現自動化生成數據中心的售前方案

整理版摘要

呢篇文章係一位技術人分享嘅實戰經驗，佢想解決嘅問題係：點樣用好 Claude Code 嘅 Skills 機制，嚟自動化生成數據中心嘅售前方案。作者先逐步教點樣安裝 Claude Code、設定模型同環境，再解釋 Skills 嘅結構同漸進式加載原理，最後用一個完整嘅實例——「dcim-proposal-architect」技能——示範點樣由零開始建立一個針對售前方案生成嘅自訂技能。

作者指出 Skills 嘅核心係 SKILL.md 檔案，入面嘅 YAML frontmatter 嘅 description 決定咗技能會唔會被觸發，而 body 就係俾 Claude 睇嘅操作手冊。成個設計嘅重點係「漸進式披露」：元信息先佔用少量上下文，需要細節時先再載入正文同參考文件，咁樣可以慳 token 同保持思路清晰。

整體結論係：只要掌握咗 Skills 嘅構建方法，就算係非開發人員都可以快速建立一套自動化嘅文件生成系統，大幅減少重複勞動，提升售前階段嘅效率。作者強調呢個方法特別適合需要大量文檔重複生成嘅場景，例如標書、方案、報價等。

  • 結論：自定義 Skills 可以大幅提升售前方案嘅自動化生成效率，減少重複勞動。
  • 方法：安裝 Claude Code 後，透過配置 API 模型同下載官方 Skills，再自訂 SKILL.md 同資源目錄。
  • 差異：Skills 採用漸進式加載機制，元信息、正文、腳本同參考文件逐層載入，唔會一次過塞滿上下文窗口。
  • 啟發：SKILL.md 嘅 description 係觸發技能嘅關鍵，寫得好先可以精準控制 Claude 使用邊個技能。
  • 可行動點：可以參考文中嘅實例，建立自己領域嘅 Skills，例如金融、醫療、教育等，只需更換 references 同 assets 就得。
整理重點

Claude Code 安裝與環境配置

Claude Code 係一個智能編碼工具，安裝喺終端之後可以用自然語言指令同佢互動。作者推薦 MacOS/Linux 用 curl 或 Homebrew 安裝，Windows 就用 PowerShell 或 WinGet。最重要嘅一步係設定 API 模型：要喺用戶目錄嘅 .claude 配置檔入面填入 API token 同基本 URL，仲有留意要將 includeCoAuthoredBy 設為 false 跳過登錄。

設定 includeCoAuthoredBy 為 false 跳過登錄

安裝完之後，喺項目目錄執行 claude 命令就可以見到歡迎畫面，代表成功運行。

整理重點

Skills 嘅核心原理同結構

剛裝好 Claude Code 嗰陣，Skills 目錄係空嘅。作者建議去 Anthropic 官方 GitHub 下載基礎 Skills，放到 ~/.claude/skills 目錄，咁就可以即刻擁有 18 個技能，例如文檔處理、前端設計、圖表生成等。

官方 Skills 提供咗大量基礎能力，可以直接下載使用

每個 Skill 係一個文件夾，必須有 SKILL.md 做主文件，入面分兩部分：YAML frontmatter 記載 name 同 description，body 就係操作指令。可選目錄包括 scripts（可執行腳本）、references（參考文檔）同 assets（輸出素材）。

  1. 1 SKILL.md：技能嘅靈魂，description 決定咗 Claude 幾時觸發呢個技能。
  2. 2 scripts/：放可重用腳本，例如生成 PDF、調用 API，可以直接執行唔佔上下文。
  3. 3 references/：參考資料，Claude 按需讀取，唔會一開始就載入。
  4. 4 assets/：輸出素材，例如 Logo、模板、字體，喺生成最終文件時直接用。

漸進式披露設計：第一層元信息始終喺上下文，第二層正文觸發後載入，第三層資源按需讀取

整理重點

實戰：建立售前方案生成技能

作者以數據中心售前方案為例，設計咗一個叫 dcim-proposal-architect 嘅技能。首先要規劃參考資料庫，包括售前方案模型、設備參數、系統功能描述、客戶案例等，全部放喺 references 目錄。然後建立 INDEX.md 做索引，方便 Claude 按需揀文件。

INDEX.md 係管理大量參考文件嘅關鍵，避免一次過載入所有檔案

SKILL.md 嘅設計要點：角色定義為 10 年經驗嘅售前架構師；策略係「Index-First」；工作流分四步——分析需求查索引、精準讀取相關文件、內容構建（引用 assets 嘅圖片同模板）、最後用 docx 技能生成 Word。

SKILL.md 核心部分 markdown 
---
name: dcim-proposal-architect
description: 當用戶要求生成數據中心售前方案、解決方案或標書時觸發此技能。
metadata:
 author: wengl
 version: "1.0"
---

# 數據中心售前方案生成專家（dcim-proposal-architect）

## 角色定義 (Role)
你是一名擁有10年經驗的資深數據中心售前架構師。

## 策略 (Strategy)
遵循 **"Index-First" (索引優先)** 策略。

## 工作流 (Process)
1. 分析需求與查閲索引
2. 精準讀取相關文件（僅讀取選中文件的全文）
3. 內容構建：引用 assets 圖片，按模板生成
4. 使用 docx 技能輸出 Word 文檔

工作流第四步「使用 docx 技能生成 Word」展示咗技能之間可以互相調用

最後，作者示範咗點樣執行呢個技能：喺 Claude Code 輸入 /dcim-proposal-architect 後面跟需求，佢會自動調用 pdf、docx、xlsx 等其他技能，最終生成一份圖文並茂嘅 Word 售前方案。

整理重點

運行效果同總結

執行過程中會自動調用相關 Skill，例如 docx 同 xlsx，形成技能協作

作者展示咗實際執行嘅日誌：Claude 首先分析需求，讀取 INDEX.md 確定要邊幾個文件，然後用對應嘅 skill 提取內容，最後合成 Word 文件。成個過程用戶只需下一句指令，慳返大量手動整理嘅時間。

  • 文末作者列出咗一系列相關文章連結，包括 AI 編程、知識庫搭建、Agent 等主題，可以延伸閲讀。
  • 如果你都係做售前或者需要大量文檔生成，呢個方法絕對值得試嚇。
圖片
一、Claude Code 環境搭建
Claude Code 係一個智能編碼工具，存在喺你嘅終端入面，明你嘅代碼庫，仲可以透過執行常規任務、解釋複雜代碼同處理 git 工作流程，幫你更快咁編碼——所有呢啲都可以用自然語言命令搞掂。喺終端、IDE 或者 Github 上面標記 @claude 就可以用佢。

1.1、安裝 Claude Code:

  • MacOS/Linux (推薦):

    curl -fsSL https://claude.ai/install.sh | bash

    • Homebrew (MacOS/Linux):

      brew install --cask claude-code

      • Windows (推薦):

        irm https://claude.ai/install.ps1 | iex

        • WinGet (Windows):

          winget install Anthropic.ClaudeCode

            • NPM（已棄用）：

              npm install -g @anthropic-ai/claude-code

              1.2、入你嘅項目目錄然後運行 claude

              # powershell 運行
C:\Users\HP> claude

              見到下面個命令行輸出，就表示已經成功運行

              圖片

              注意：執行安裝命令之後，例如：irm https://claude.ai/install.ps1 | iex

              會提示要添加環境變量，將 claude 執行嘅 exe 目錄 `C:\Users\HP\.local\bin` 加落 Path 度就得。
              3、如果你想用 Claude 模型，仲要安裝Antigravity Tools v4.0.10
              下載地址：
              https://github.com/lbjlaq/Antigravity-Manager/releases/tag/v4.0.10
              4、喺用戶目錄 .claude 配置 claude code 嘅大模型
              {
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-f2e1c87e0c50465c95feeabddbe7538b",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8045",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_MODEL": "claude-opus-4-5-20251101",
    "ANTHROPIC_REASONING_MODEL": "claude-sonnet-4-5"
  },
  "includeCoAuthoredBy": false,
  "enabledPlugins": {
    "webapp-testing@awesome-claude-skills": true
  },
  "model": "opus"
}
              特別注意：includeCoAuthoredBy = false 跳過登錄！
              5、跟住就可以開開心心咁用 Claude Code 做我哋想做到嘅嘢喇！
              
╭─── Claude Code v2.1.27 ──────────────────────────────────────────────────────────────────────────────────────────────╮
│                                  │ Tips for getting started                                                          │
│           Welcome back!          │ Run /init to create a CLAUDE.md file with instructions for Claude                 │
│                                  │ ─────────────────────────────────────────────────────────────────                 │
│                                  │ Recent activity                                                                   │
│              ▐▛███▜▌             │ No recent activity                                                                │
│             ▝▜█████▛▘            │                                                                                   │
│               ▘▘ ▝▝              │                                                                                   │
│   Opus 4.5 · API Usage Billing   │                                                                                   │
│            ~\.claude             │                                                                                   │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

  Welcome to Opus 4.5

> 你好                                                                                                                  
●你好！有什麼我可以幫助你的嗎？

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────> 
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  ? for shortcuts
              二、Skills 嘅介紹
              2.1、啱啱安裝完 Claude Code Skills 係空嘅，我哋可以打 /skills 命令睇下
              > /skills                                                                                                               ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Skills                                                                                                                  No skills found
 No skills found
 Create skills in .claude/skills/ or ~/.claude/skills/
 Esc to close
              可以見到 skills 係空嘅，呢個時候我哋可以檢查  ~/.claude/skills/ 目錄應該係空嘅。
              唔使急，官方已經提供咗好多基本嘅 skills，我哋可以喺呢度下載返嚟本地用，下載地址：
              https://github.com/anthropics/skills/tree/main/skills
              圖片
              包括：skill 創建器、文檔處理、mcp、圖表設計，前端設計等，我哋將呢啲下載之後放落本地目錄：C:\Users\HP\.claude\skills
              圖片
              咁樣，你就會擁有咁多技能，而家只要你諗得到嘅，佢都可以幫你實現！我哋重新入到 Claude Code 之後，再次執行 /skills
              > /skills                                                                                                                                                                            ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Skills                                                                                                                                                                               18 skills

 User skills (skills)
 xlsx · ~113 description tokens
 doc-coauthoring · ~111 description tokens
 frontend-design · ~104 description tokens
 docx · ~92 description tokens
 internal-comms · ~86 description tokens
 algorithmic-art · ~85 description tokens
 web-artifacts-builder · ~78 description tokens
 canvas-design · ~76 description tokens
 mcp-builder · ~72 description tokens
 pptx · ~69 description tokens
 theme-factory · ~69 description tokens
 pdf · ~64 description tokens
 brand-guidelines · ~63 description tokens
 slack-gif-creator · ~61 description tokens
 skill-creator · ~60 description tokens
 webapp-testing · ~55 description tokens
 browser-automation · ~46 description tokens
 dcim-proposal-architect · ~14 description tokens

 Esc to close
              2.2、Skills 原理

              而家 Skills 嘅來源有兩個：

              1. 1. Anthropic 官方 Marketplace —— 官方維護嘅高質素 Skills
              2. 2. 社區開源 —— GitHub 上面嘅第三方 Skills

              通過 openskills 呢個 CLI 工具可以方便你安裝、管理呢啲 Skills。

              廢話少講，直接開始。

              2. 核心概念：Skills 嘅組成結構

              Skill 嘅目錄結構

              每個 Skill 本身係一個文件夾，包含以下內容：

              skill-name/
              ├── SKILL.md          # 必需：主文件，包含元信息和指令
              ├── scripts/          # 可選：可執行腳本（Python/Bash 等）
              ├── references/       # 可選：參考文檔（按需加載）
              └── assets/           # 可選：輸出素材（模板/圖片/字體等）

              結構睇落簡單，但每個部分都有明確嘅分工。

              圖片

              SKILL.md：Skill 嘅靈魂

              SKILL.md 係每個 Skill 一定要有嘅文件，由兩部分組成：

              1. YAML Frontmatter（元信息）

              ---
              name: deep-research
              description: 生成結構化的深度研究報告。支持多來源信息整合、
                自動生成大綱、分章節撰寫。當用戶需要研究某個主題、
                撰寫調研報告、或進行競品分析時使用此 Skill。
              ---

              呢度有兩個字段：

              字段
              作用
              重要程度
              name
              Skill 嘅唯一標識
              ⭐⭐⭐
              description
              觸發條件，決定幾時啟用呢個 Skill
              ⭐⭐⭐⭐⭐

              關鍵點：description 係 Claude 決定係咪用呢個 Skill 嘅唯一依據。寫得好唔好，直接決定咗 Skill 能唔能夠被正確觸發。

              2. Markdown Body（指令正文）

              # Deep Research Skill

              ## 工作流程
              1. 確認研究主題和範圍
              2. 生成研究大綱
              3. 分章節收集資料
              4. 整合撰寫報告
              5. 生成參考文獻

              ## 輸出格式
              使用 scripts/generate_report.py 生成最終 PDF...

              正文部分係俾 Claude 睇嘅「操作手冊」，話俾佢知具體點樣執行任務。

              scripts/：可複用嘅腳本

              呢個目錄放嘅係可執行代碼，適合呢啲情況：

              • • 每次都要重寫嘅代碼 —— 例如 PDF 生成、圖片處理
              • • 需要確定性結果嘅操作 —— 唔可以俾 AI 每次都寫唔同嘅代碼
              • • 複雜嘅技術操作 —— 例如調用特定 API
              scripts/
              ├── generate_report.py    # 生成 PDF 報告
              ├── fetch_data.py         # 獲取外部數據
              └── validate_output.sh    # 校驗輸出格式

              優點：腳本可以直接執行，唔需要加載到上下文窗口，慳 token 又穩定。

              references/：參考文檔

              呢個目錄放嘅係 Claude 可能需要參考嘅文檔資料：

              references/
              ├── report_template.md    # 報告模板
              ├── style_guide.md        # 寫作風格指南
              └── api_docs.md           # API 文檔

              重點：references 裏面嘅文件唔會一開始就加載，而係 Claude 按需讀取。呢個就係「漸進式披露」嘅設計理念——需要嘅時候先加載，唔會霸佔寶貴嘅上下文空間。

              assets/：輸出素材

              呢個目錄放嘅係最終輸出會用到嘅素材：

              assets/
              ├── logo.png              # 品牌 Logo
              ├── template.docx         # Word 模板
              ├── fonts/                # 自定義字體
              └── cover_template.html   # 封面模板

              呢啲文件唔會被讀入上下文，而係喺生成最終產物嗰陣直接使用。

              漸進式披露：三層加載機制

              Skills 採用咗一個聰明嘅設計——漸進式披露，分三層按需加載：

              ┌───────────────────────────────────────┐
              │  第 1 層：元信息（始終在上下文中）      │
              │  name + description，約 100 詞         │
              ├───────────────────────────────────────┤
              │  第 2 層：SKILL.md 正文（觸發後加載）   │
              │  建議控制在 500 行以內                  │
              ├────────────────────────────────────────┤
              │  第 3 層：bundled resources（按需加載） │
              │  scripts/、references/、assets/        │
              │  無上限，因為腳本可以直接執行不佔上下文  │
              └────────────────────────────────────────┘

              點解要咁設計？

              上下文窗口係稀缺資源。如果將所有信息一次過塞曬入去，唔單止浪費 token，仲可能會「淹沒」真正重要嘅信息。漸進式披露令 Claude 先見到概要，需要細節時再深入——好似人類睇文檔咁。

              圖片

              小結

              組件
              作用
              加載時機
              SKILL.md frontmatter
              觸發判斷
              始終加載
              SKILL.md body
              執行指令
              觸發後加載
              scripts/
              可執行代碼
              按需執行
              references/
              參考資料
              按需讀取
              assets/
              輸出素材
              生成時使用

              三、跟住我哋實戰，實現一個自己嘅售前方案生成嘅 Skill

              3.1、業務規劃
              生成售前方案，本地知識庫嘅建設好重要，我哋需要大量嘅行業資料、技術資料等
              • 市場售前
              • 選型指導
              • 踏勘指導
              • 商務報價
              • 招標投標
              • 安裝調試
              • 客戶案例
              • 系統功能
              • 研發團隊
              • 施工方案
              喺呢裏面比較重要嘅資料有：售前方案模型、設備選型技術參數、系統功能描述、技術架構、客戶案例。
              3.2、skill 業務架構設計
              assets/
              ├── logo.png              # 品牌 Logo
              ├── template.docx         # Word 模板
              ├── fonts/                # 自定義字體
              ├── xx功能.png             # 系統功能截圖
              └── 技術架構.png           # 技術架構圖
              references/
              ├── INDEX.md    # 文檔索引
              ├── xxx檔案庫    # 所有相關的資料
              SKILL.md         # Skill主要工作流定義
              其中文檔索引比較重要，因為 Skill 加載資源係漸進式加載，可以按需要去按需加載，所以我哋需要喺 INDEX.md 入面定義好各文檔嘅名稱、內容簡介、適用場景、文檔路徑。
              # 資料庫索引 (Knowledge Base Index)

| 文件名 | 內容簡介 | 適用場景 | 文檔路徑 |
| :--- | :--- | :--- |
| `動環監控系統功能模塊描述.docx` | 動環監控系統的功能介紹，包含：大屏、系統界面、設施監控、告警管理、報表管理、能效管理、容量管理、通訊拓撲、權限管理、日誌管理、監控中心|  適合功能描述介紹 | ./references/數據中心產品技術檔案/0.市場售前/動環監控系統功能模塊描述.docx |
| `施工方案.docx` | 包含工程實施目標、施工管理組織架構、施工方案、施工進度計劃、成品保護措施、施工質量管理、施工安全等 | 涉及施工相關的內容。 | ./references/數據中心產品技術檔案/0.市場售前/施工方案.docx |
| `研發團隊人員介紹.docx` | 整體研發團隊的介紹，社保情況。 | 針對方案中的團隊介紹。 | ./references/數據中心產品技術檔案/0.市場售前/研發團隊人員介紹.docx |
| `火山雲太行算力中心-機房樓動環監控系統技術回標文件.docx` | 針對火山雲太行算力中心的售前技術方案樣例文檔 | 可以作為參考 | ./references/數據中心產品技術檔案/6.客戶案例/火山雲太行算力中心-機房樓動環監控系統技術回標文件.docx |
 
 .....
              3.3、Skill 腳本編寫
              ---
name: dcim-proposal-architect
description: 當用戶要求生成數據中心售前方案、解決方案或標書時觸發此技能。
metadata:
  author: wengl
  version: "1.0"
---

# 數據中心售前方案生成專家（dcim-proposal-architect）

## 角色定義 (Role)
你是一名擁有10年經驗的資深數據中心售前架構師。你的核心能力是理解複雜的客戶需求，結合公司產品文檔，輸出邏輯嚴密、極具說服力的中文解決方案。

## 策略 (Strategy)
為了高效處理大量文檔，你必須遵循 **"Index-First" (索引優先)** 策略。不要一次性加載所有文件的全文。

## 功能
- 讀取技術要求的文件內容，明確用戶需求，技術要求路徑：`./references/技術要求` 
- 根據提供的模板文件，生成結構化的售前解決方案文檔，模板路徑：`./assets/動環監控系統技術方案格式模板.docx`
- 支持自定義輸出格式（Markdown/Word/PDF)

## 觸發條件 (Triggers)
- 用戶說：“幫我寫個方案”、“生成售前文檔”或“整理標書素材”。
- 用戶上傳了需求文檔並要求中文回覆。

## 工作流 (Process)

1.  **分析需求與查閲索引**
    - 分析用戶的請求（例如：“我要一份給銀行客戶的報價方案”）。
    - **關鍵動作**：讀取 `./references/INDEX.md` 文件。
    - **決策**：根據索引描述，判斷哪幾個文件與當前任務相關？
        - *思考示例*：用戶問的是“銀行”和“報價”，所以我只需要讀取 `Case_Study_Finance.docx` 和 `Pricing_2026_Q1.xlsx`。不需要讀取技術白皮書。

2.  **精準讀取**
    - 使用工具或指令,如：docx/pdf/xlsx 請分別使用對應的 skill 進行讀取，僅讀取第一階段選中的那幾個文件的**全文內容**。
	- 重點需要查看 `./references/數據中心產品技術檔案/0.市場售前` 裏面的功能描述，施工方案，研發團隊介紹
    - 忽略其他不相關文件，以保持思維清晰。
	- docx/pdf/xlsx 請分別使用對應的 skill 進行讀取

3.  **內容構建 (Drafting)**:
    - **語言要求**: 輸出**簡體中文**。
    - **語氣風格**: 商務、專業、自信。避免生硬的翻譯腔。
	- **靜態資源應用** 需要引用 `./assets` 目錄下面的圖片嵌入到文檔中，包含產品圖片，系統架構，系統功能圖片
    - **結構**: 嚴格按照模板格式生成，模板路徑：`./assets/動環監控系統技術方案格式模板.docx`
	- 最後使用docx 技能生成word文檔，如果未指定目錄，默認生成在當前用戶目錄

4.  **特殊處理**:
    - 如果資料是英文的，請自動翻譯並意譯為流暢的中文。
    - 專有名詞（如 AI Agent, Docker, CI/CD）保留英文。

## 約束 (Constraints)
- **禁止**在第一步就讀取 `./references` 下的所有文件，這會浪費資源並導致混淆。
- 始終基於證據說話，引用具體的文件名作為來源（例如：“根據 `Pricing_2026.xlsx`，標準版價格為...”）。

## 輸出格式 (Output)
- 請生成一個 Word 文件，並且要圖文並茂（例如：`售前方案_客戶名稱_日期.docx`）。
- 不要在對話框裏直接輸出長篇大論，直接給我文件連結。
              3.4、運行我哋嘅 Skill 
              >/dcim-proposal-architect 根據C:\Users\HP\.claude\skills\dcim-proposal-architect\references\技術要求 中的技術要求生成對應的售前方案

              喺執行我哋呢個 Skill 嘅過程中，佢會自動調用需要嘅其他 Skill，例如：pdf、docx、xlsx 等。

              執行情況概覽
               /dcim-proposal-architect 根據C:\Users\HP\.claude\skills\dcim-proposal-architect\references\技術要求 中的技術要求生成對應的售前方案                                                 
●P好的，我來按照工作流程為您生成售前方案。首先讀取索引文件和技術要求。

● Reading 1 file… (ctrl+o to expand)     
●S  rchied for 1 pattern, read 1 file (ctrl+o to expand)
   ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
● Skill(pdf)                                                                                                                                                                          
  ⎿─ Successfully─loaded─skill─────────────────────────────────────────────────────────────────────────────────────────────────────

● Reading 1 file… (ctrl+o to expand)   
我來按照工作流程為您生成這份售前方案。                                                                                                                                                                                                    

  第一步：分析需求與查閲索引

  讓我先讀取索引文件，瞭解可用的參考資料：

● Read(skills\proposal-architect\references\INDEX.md)                                                                                                                                                                                       
  ⎿  Read 8 lines

● 根據用戶需求（xxxxxxx），我需要讀取以下相關文件：                                                                                                                                                                   

    1. xxxxx.docx - 獲取平台框架和功能介紹
    2. xxxx選型說明-20220307.xlsx - 獲取產品選型參數
    3. xxxx價格-售前方案報價2022.xlsx - 獲取報價信息

  第二步：精準讀取相關文件

● Skill(docx)                                                                                                                                                                                                                               
  ⎿  Successfully loaded skill

● Skill(xlsx)                                                                                                                                                                                                                               
  ⎿  Successfully loaded skill

● 我來讀取這兩個文件的內容：                                                                                                                                                                                                                

● Bash(pandoc "C:\Users\wengl\.claude\skills\proposal-architect\references\空調雲產品技術檔案\0.市場售前\分體空調智慧管理平台技術方案（簡要版）.docx" -o /tmp/tech_solution.md 2>/dev/null && cat /tmp/…)                                  
  ⎿ **xxx智慧管理平台技術**

    **技術原理。**xxx安裝位置的關係，房間內的温度場並不均勻，且空調自身控制温度點與用戶停留去感受温度有較大差異，使得空調製冷/制熱工作存在一定過度電能消耗，為改善用戶的舒適度體驗，可在每個房間加裝一個無線温度傳感器。將其安裝在
    用
    … +31 lines (ctrl+o to expand)                                                                                                                                                                                                          

● Bash(cd "C:\Users\wengl\.claude\skills\proposal-architect\references\空調雲產品技術檔案\3.商務報價" && python3 -c "                                                                                                                       
      import pandas as pd…)                                                                                                                                                                                                                 
  ⎿  Error: Exit code 49

● 讓我嘗試用另一種方式讀取Excel文件：           

............

●B✅ 售前方案已生成完成！  8   ·   tokens)
  文檔路徑： C:\Users\wengl.claude\skills\dcim-proposal-architect\數據中心平台技術方案_2025.docx                                                                                                                             
  ---

              往期推薦



              圖片
              一、Claude Code 環境搭建
              Claude Code 是一個智能編碼工具，它存在於你的終端中，理解你的代碼庫，並通過執行常規任務、解釋複雜代碼和處理 git 工作流程，幫助你更快地編碼——所有這些都可以通過自然語言命令完成。在終端、IDE 或 Github 上標記@claude 來使用它。

              1.1、安裝 Claude Code:

              • MacOS/Linux (推薦):

                curl -fsSL https://claude.ai/install.sh | bash

                • Homebrew (MacOS/Linux):

                  brew install --cask claude-code

                  • Windows (推薦):

                    irm https://claude.ai/install.ps1 | iex

                    • WinGet (Windows):

                      winget install Anthropic.ClaudeCode

                        • NPM（已棄用）：

                          npm install -g @anthropic-ai/claude-code

                          1.2、進入你的項目目錄並運行 claude

                          # powershell 運行
C:\Users\HP> claude

                          看到如下命令行輸出，說明已經運行成功

                          圖片

                          注意：執行安裝命令後，如：irm https://claude.ai/install.ps1 | iex

                          會提示需要添加環境變量，把claude 執行的exe目錄`C:\Users\HP\.local\bin`添加到Path即可.
                          3、如果想要使用Claude 模型，你還需要安裝Antigravity Tools v4.0.10
                          下載地址：
                          https://github.com/lbjlaq/Antigravity-Manager/releases/tag/v4.0.10
                          4、在用戶目錄.claude 配置claude code的大模型
                          {
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-f2e1c87e0c50465c95feeabddbe7538b",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8045",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_MODEL": "claude-opus-4-5-20251101",
    "ANTHROPIC_REASONING_MODEL": "claude-sonnet-4-5"
  },
  "includeCoAuthoredBy": false,
  "enabledPlugins": {
    "webapp-testing@awesome-claude-skills": true
  },
  "model": "opus"
}
                          特別注意：includeCoAuthoredBy = false 跳過登錄！
                          5、接下來就可以愉快的使用Claude Code 做我們想做的事情了！
                          
╭─── Claude Code v2.1.27 ──────────────────────────────────────────────────────────────────────────────────────────────╮
│                                  │ Tips for getting started                                                          │
│           Welcome back!          │ Run /init to create a CLAUDE.md file with instructions for Claude                 │
│                                  │ ─────────────────────────────────────────────────────────────────                 │
│                                  │ Recent activity                                                                   │
│              ▐▛███▜▌             │ No recent activity                                                                │
│             ▝▜█████▛▘            │                                                                                   │
│               ▘▘ ▝▝              │                                                                                   │
│   Opus 4.5 · API Usage Billing   │                                                                                   │
│            ~\.claude             │                                                                                   │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

  Welcome to Opus 4.5

> 你好                                                                                                                  
●你好！有什麼我可以幫助你的嗎？

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────> 
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  ? for shortcuts
                          二、Skills的介紹
                          2.1、剛安裝Claude Code Skills 空的，我們可以支行 /skills 命令看看
                          > /skills                                                                                                               ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Skills                                                                                                                  No skills found
 No skills found
 Create skills in .claude/skills/ or ~/.claude/skills/
 Esc to close
                          可以發現skills 是空的，這時我們可以查看  ~/.claude/skills/ 目錄應該是空的。
                          彆着急官方已經提供了很多基礎的skills，我們可以從這裏下載到我們本地使用，下載地址：
                          https://github.com/anthropics/skills/tree/main/skills
                          圖片
                          包含：skill創建器、文檔處理、mcp、圖表設計，前端設計等，我們把這些下載後放到本地目錄：C:\Users\HP\.claude\skills
                          圖片
                          此時，你將擁有如此多的技能，現在只要你想得到的，他都能幫你實現！我們重新進入Claude Code後，再次執行/skills
                          > /skills                                                                                                                                                                            ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Skills                                                                                                                                                                               18 skills

 User skills (skills)
 xlsx · ~113 description tokens
 doc-coauthoring · ~111 description tokens
 frontend-design · ~104 description tokens
 docx · ~92 description tokens
 internal-comms · ~86 description tokens
 algorithmic-art · ~85 description tokens
 web-artifacts-builder · ~78 description tokens
 canvas-design · ~76 description tokens
 mcp-builder · ~72 description tokens
 pptx · ~69 description tokens
 theme-factory · ~69 description tokens
 pdf · ~64 description tokens
 brand-guidelines · ~63 description tokens
 slack-gif-creator · ~61 description tokens
 skill-creator · ~60 description tokens
 webapp-testing · ~55 description tokens
 browser-automation · ~46 description tokens
 dcim-proposal-architect · ~14 description tokens

 Esc to close
                          2.2、Skills 原理

                          目前 Skills 的來源有兩個：

                          1. 1. Anthropic 官方 Marketplace —— 官方維護的高質量 Skills
                          2. 2. 社區開源 —— GitHub 上的第三方 Skills

                          通過 openskills 這個 CLI 工具，你可以方便地安裝、管理這些 Skills。

                          廢話不多說，直接上手。

                          2. 核心概念：Skills 的組成結構

                          Skill 的目錄結構

                          每個 Skill 本質上就是一個文件夾，包含以下內容：

                          skill-name/
                          ├── SKILL.md          # 必需：主文件，包含元信息和指令
                          ├── scripts/          # 可選：可執行腳本（Python/Bash 等）
                          ├── references/       # 可選：參考文檔（按需加載）
                          └── assets/           # 可選：輸出素材（模板/圖片/字體等）

                          結構看着簡單，但每個部分都有明確的分工。

                          圖片

                          SKILL.md：Skill 的靈魂

                          SKILL.md 是每個 Skill 必須有的文件，由兩部分組成：

                          1. YAML Frontmatter（元信息）

                          ---
                          name: deep-research
                          description: 生成結構化的深度研究報告。支持多來源信息整合、
                            自動生成大綱、分章節撰寫。當用戶需要研究某個主題、
                            撰寫調研報告、或進行競品分析時使用此 Skill。
                          ---

                          這裏有兩個字段：

                          字段
                          作用
                          重要程度
                          name
                          Skill 的唯一標識
                          ⭐⭐⭐
                          description
                          觸發條件，決定何時啓用此 Skill
                          ⭐⭐⭐⭐⭐

                          關鍵點：description 是 Claude 決定是否使用這個 Skill 的唯一依據。寫得好不好，直接決定了 Skill 能不能被正確觸發。

                          2. Markdown Body（指令正文）

                          # Deep Research Skill

                          ## 工作流程
                          1. 確認研究主題和範圍
                          2. 生成研究大綱
                          3. 分章節收集資料
                          4. 整合撰寫報告
                          5. 生成參考文獻

                          ## 輸出格式
                          使用 scripts/generate_report.py 生成最終 PDF...

                          正文部分是給 Claude 看的"操作手冊"，告訴它具體怎麼執行任務。

                          scripts/：可複用的腳本

                          這個目錄放的是可執行代碼，適合那些：

                          • • 每次都要重寫的代碼 —— 比如 PDF 生成、圖片處理
                          • • 需要確定性結果的操作 —— 不能讓 AI 每次寫不一樣的代碼
                          • • 複雜的技術操作 —— 比如調用特定 API
                          scripts/
                          ├── generate_report.py    # 生成 PDF 報告
                          ├── fetch_data.py         # 獲取外部數據
                          └── validate_output.sh    # 校驗輸出格式

                          優點：腳本可以直接執行，不需要加載到上下文窗口，省 token 又穩定。

                          references/：參考文檔

                          這個目錄放的是 Claude 可能需要參考的文檔資料：

                          references/
                          ├── report_template.md    # 報告模板
                          ├── style_guide.md        # 寫作風格指南
                          └── api_docs.md           # API 文檔

                          重點：references 裏的文件不會一開始就加載，而是 Claude 按需讀取。這就是"漸進式披露"的設計理念——需要的時候再加載，不佔用寶貴的上下文空間。

                          assets/：輸出素材

                          這個目錄放的是最終輸出會用到的素材：

                          assets/
                          ├── logo.png              # 品牌 Logo
                          ├── template.docx         # Word 模板
                          ├── fonts/                # 自定義字體
                          └── cover_template.html   # 封面模板

                          這些文件不會被讀取到上下文裏，而是在生成最終產物時直接使用。

                          漸進式披露：三層加載機制

                          Skills 採用了一個聰明的設計——漸進式披露，分三層按需加載：

                          ┌───────────────────────────────────────┐
                          │  第 1 層：元信息（始終在上下文中）      │
                          │  name + description，約 100 詞         │
                          ├───────────────────────────────────────┤
                          │  第 2 層：SKILL.md 正文（觸發後加載）   │
                          │  建議控制在 500 行以內                  │
                          ├────────────────────────────────────────┤
                          │  第 3 層：bundled resources（按需加載） │
                          │  scripts/、references/、assets/        │
                          │  無上限，因為腳本可以直接執行不佔上下文  │
                          └────────────────────────────────────────┘

                          為什麼這麼設計？

                          上下文窗口是稀缺資源。如果把所有信息一股腦塞進去，不僅浪費 token，還可能"淹沒"真正重要的信息。漸進式披露讓 Claude 先看到概要，需要細節時再深入——就像人類讀文檔一樣。

                          圖片

                          小結

                          組件
                          作用
                          加載時機
                          SKILL.md frontmatter
                          觸發判斷
                          始終加載
                          SKILL.md body
                          執行指令
                          觸發後加載
                          scripts/
                          可執行代碼
                          按需執行
                          references/
                          參考資料
                          按需讀取
                          assets/
                          輸出素材
                          生成時使用

                          三、接下來我們實操，實現一個我們自己的售前方案生成的Skill

                          3.1、業務規劃
                          生成售前方案，本地知識庫的建設很重要，我們需要大量的行業資料，技術資料等
                          • 市場售前
                          • 選型指導
                          • 踏勘指導
                          • 商務報價
                          • 招標投標
                          • 安裝調試
                          • 客戶案例
                          • 系統功能
                          • 研發團隊
                          • 施工方案
                          在這裏面比較重要的資料有：售前方案模型、設備選型技術參數、系統功能描述、技術架構、客戶案例。
                          3.2、skill 業務架構設計
                          assets/
                          ├── logo.png              # 品牌 Logo
                          ├── template.docx         # Word 模板
                          ├── fonts/                # 自定義字體
                          ├── xx功能.png             # 系統功能截圖
                          └── 技術架構.png           # 技術架構圖
                          references/
                          ├── INDEX.md    # 文檔索引
                          ├── xxx檔案庫    # 所有相關的資料
                          SKILL.md         # Skill主要工作流定義
                          其中 文檔索引比較重要，因為Skill加載資源是漸進式加載的，可以根據需要過按需加載，所以我們需要在INDEX.md中定義好我們各文檔的名稱、內容簡介、適用場景、文檔路徑。
                          # 資料庫索引 (Knowledge Base Index)

| 文件名 | 內容簡介 | 適用場景 | 文檔路徑 |
| :--- | :--- | :--- |
| `動環監控系統功能模塊描述.docx` | 動環監控系統的功能介紹，包含：大屏、系統界面、設施監控、告警管理、報表管理、能效管理、容量管理、通訊拓撲、權限管理、日誌管理、監控中心|  適合功能描述介紹 | ./references/數據中心產品技術檔案/0.市場售前/動環監控系統功能模塊描述.docx |
| `施工方案.docx` | 包含工程實施目標、施工管理組織架構、施工方案、施工進度計劃、成品保護措施、施工質量管理、施工安全等 | 涉及施工相關的內容。 | ./references/數據中心產品技術檔案/0.市場售前/施工方案.docx |
| `研發團隊人員介紹.docx` | 整體研發團隊的介紹，社保情況。 | 針對方案中的團隊介紹。 | ./references/數據中心產品技術檔案/0.市場售前/研發團隊人員介紹.docx |
| `火山雲太行算力中心-機房樓動環監控系統技術回標文件.docx` | 針對火山雲太行算力中心的售前技術方案樣例文檔 | 可以作為參考 | ./references/數據中心產品技術檔案/6.客戶案例/火山雲太行算力中心-機房樓動環監控系統技術回標文件.docx |
 
 .....
                          3.3、Skill 腳本編寫
                          ---
name: dcim-proposal-architect
description: 當用戶要求生成數據中心售前方案、解決方案或標書時觸發此技能。
metadata:
  author: wengl
  version: "1.0"
---

# 數據中心售前方案生成專家（dcim-proposal-architect）

## 角色定義 (Role)
你是一名擁有10年經驗的資深數據中心售前架構師。你的核心能力是理解複雜的客戶需求，結合公司產品文檔，輸出邏輯嚴密、極具說服力的中文解決方案。

## 策略 (Strategy)
為了高效處理大量文檔，你必須遵循 **"Index-First" (索引優先)** 策略。不要一次性加載所有文件的全文。

## 功能
- 讀取技術要求的文件內容，明確用戶需求，技術要求路徑：`./references/技術要求` 
- 根據提供的模板文件，生成結構化的售前解決方案文檔，模板路徑：`./assets/動環監控系統技術方案格式模板.docx`
- 支持自定義輸出格式（Markdown/Word/PDF)

## 觸發條件 (Triggers)
- 用戶說：“幫我寫個方案”、“生成售前文檔”或“整理標書素材”。
- 用戶上傳了需求文檔並要求中文回覆。

## 工作流 (Process)

1.  **分析需求與查閲索引**
    - 分析用戶的請求（例如：“我要一份給銀行客戶的報價方案”）。
    - **關鍵動作**：讀取 `./references/INDEX.md` 文件。
    - **決策**：根據索引描述，判斷哪幾個文件與當前任務相關？
        - *思考示例*：用戶問的是“銀行”和“報價”，所以我只需要讀取 `Case_Study_Finance.docx` 和 `Pricing_2026_Q1.xlsx`。不需要讀取技術白皮書。

2.  **精準讀取**
    - 使用工具或指令,如：docx/pdf/xlsx 請分別使用對應的 skill 進行讀取，僅讀取第一階段選中的那幾個文件的**全文內容**。
	- 重點需要查看 `./references/數據中心產品技術檔案/0.市場售前` 裏面的功能描述，施工方案，研發團隊介紹
    - 忽略其他不相關文件，以保持思維清晰。
	- docx/pdf/xlsx 請分別使用對應的 skill 進行讀取

3.  **內容構建 (Drafting)**:
    - **語言要求**: 輸出**簡體中文**。
    - **語氣風格**: 商務、專業、自信。避免生硬的翻譯腔。
	- **靜態資源應用** 需要引用 `./assets` 目錄下面的圖片嵌入到文檔中，包含產品圖片，系統架構，系統功能圖片
    - **結構**: 嚴格按照模板格式生成，模板路徑：`./assets/動環監控系統技術方案格式模板.docx`
	- 最後使用docx 技能生成word文檔，如果未指定目錄，默認生成在當前用戶目錄

4.  **特殊處理**:
    - 如果資料是英文的，請自動翻譯並意譯為流暢的中文。
    - 專有名詞（如 AI Agent, Docker, CI/CD）保留英文。

## 約束 (Constraints)
- **禁止**在第一步就讀取 `./references` 下的所有文件，這會浪費資源並導致混淆。
- 始終基於證據說話，引用具體的文件名作為來源（例如：“根據 `Pricing_2026.xlsx`，標準版價格為...”）。

## 輸出格式 (Output)
- 請生成一個 Word 文件，並且要圖文並茂（例如：`售前方案_客戶名稱_日期.docx`）。
- 不要在對話框裏直接輸出長篇大論，直接給我文件連結。
                          3.4、運行我們的Skill 
                          >/dcim-proposal-architect 根據C:\Users\HP\.claude\skills\dcim-proposal-architect\references\技術要求 中的技術要求生成對應的售前方案

                          在執行我們這個Skill過程中，他會自動調用需要的其它Skill，比如：pdf、docx、xlsx等。

                          執行情況概覽
                           /dcim-proposal-architect 根據C:\Users\HP\.claude\skills\dcim-proposal-architect\references\技術要求 中的技術要求生成對應的售前方案                                                 
●P好的，我來按照工作流程為您生成售前方案。首先讀取索引文件和技術要求。

● Reading 1 file… (ctrl+o to expand)     
●S  rchied for 1 pattern, read 1 file (ctrl+o to expand)
   ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
● Skill(pdf)                                                                                                                                                                          
  ⎿─ Successfully─loaded─skill─────────────────────────────────────────────────────────────────────────────────────────────────────

● Reading 1 file… (ctrl+o to expand)   
我來按照工作流程為您生成這份售前方案。                                                                                                                                                                                                    

  第一步：分析需求與查閲索引

  讓我先讀取索引文件，瞭解可用的參考資料：

● Read(skills\proposal-architect\references\INDEX.md)                                                                                                                                                                                       
  ⎿  Read 8 lines

● 根據用戶需求（xxxxxxx），我需要讀取以下相關文件：                                                                                                                                                                   

    1. xxxxx.docx - 獲取平台框架和功能介紹
    2. xxxx選型說明-20220307.xlsx - 獲取產品選型參數
    3. xxxx價格-售前方案報價2022.xlsx - 獲取報價信息

  第二步：精準讀取相關文件

● Skill(docx)                                                                                                                                                                                                                               
  ⎿  Successfully loaded skill

● Skill(xlsx)                                                                                                                                                                                                                               
  ⎿  Successfully loaded skill

● 我來讀取這兩個文件的內容：                                                                                                                                                                                                                

● Bash(pandoc "C:\Users\wengl\.claude\skills\proposal-architect\references\空調雲產品技術檔案\0.市場售前\分體空調智慧管理平台技術方案（簡要版）.docx" -o /tmp/tech_solution.md 2>/dev/null && cat /tmp/…)                                  
  ⎿ **xxx智慧管理平台技術**

    **技術原理。**xxx安裝位置的關係，房間內的温度場並不均勻，且空調自身控制温度點與用戶停留去感受温度有較大差異，使得空調製冷/制熱工作存在一定過度電能消耗，為改善用戶的舒適度體驗，可在每個房間加裝一個無線温度傳感器。將其安裝在
    用
    … +31 lines (ctrl+o to expand)                                                                                                                                                                                                          

● Bash(cd "C:\Users\wengl\.claude\skills\proposal-architect\references\空調雲產品技術檔案\3.商務報價" && python3 -c "                                                                                                                       
      import pandas as pd…)                                                                                                                                                                                                                 
  ⎿  Error: Exit code 49

● 讓我嘗試用另一種方式讀取Excel文件：           

............

●B✅ 售前方案已生成完成！  8   ·   tokens)
  文檔路徑： C:\Users\wengl.claude\skills\dcim-proposal-architect\數據中心平台技術方案_2025.docx                                                                                                                             
  ---

                          往期推薦