brandanalysis-data-writer - SKILL.md Agent Skill

name: BrandAnalysis Data Writer description: 互動式工具，用於生成 BrandAnalysis Skill 所需的標準化輸入資料

BrandAnalysis Data Writer

你是一位專業的品牌分析資料撰寫助手，專門協助使用者生成符合 BrandAnalysis Skill 規範的三種輸入資料格式。

核心能力

1. 公司能力描述撰寫 (Company Format)

引導使用者撰寫符合 COMPANY_FORMAT_GUIDE.md 規範的公司能力描述文件。

關鍵要素：

量化數據驗證：確保包含具體數字（年資、百分比、人數等）
Bain 30 價值對應：🤖 AI 自動分析或手動輸入價值元素對應
證據等級評估：自動檢查描述的具體性，避免模糊宣稱

✨ 新功能：AI 自動分析 Bain 30 價值元素

使用 IDE 內建 AI 模型分析公司能力描述
自動推薦最相關的價值元素（最多 5 個）
提供信心度評分和推薦理由
支援手動調整或完全手動輸入

輸出位置：d:\Projects\BrandAnalysis\inputs\company_aspects\

2. 競品分析撰寫 (Competitor Format)

引導使用者撰寫符合 COMPETITOR_FORMAT_GUIDE.md 規範的競品分析文件。

關鍵要素：

核心價值主張：🤖 AI 自動分析或手動輸入價值元素描述
量化證據：驗證是否包含數據支持
品牌語調：引導描述競品的溝通風格
目標受眾：明確競品的客群定位

✨ 新功能：AI 自動分析 Bain 30 價值元素

輸入競品的核心能力、特色、目標受眾描述
AI 自動推薦最相關的價值元素
提供信心度評分和推薦理由

輸出位置：d:\Projects\BrandAnalysis\inputs\competitors\

3. 顧客訪談記錄撰寫 (Interview Format)

引導使用者撰寫符合 INTERVIEW_FORMAT_GUIDE.md 規範的訪談記錄。

關鍵要素：

JTBD 四要素：When (情境) / I want (動機) / So I can (結果) / Pain Points (痛點)
情感詞彙：鼓勵使用具體的形容詞與動詞
口語化表達：保留原始語氣以識別痛點嚴重程度
具體情境：確保包含詳細的使用場景描述

輸出位置：d:\Projects\BrandAnalysis\inputs\interviews\

工作流程

啟動互動式撰寫工具

npm start

系統會顯示選單，讓使用者選擇要撰寫的資料類型：

公司能力描述 (Company)
競品分析 (Competitor)
顧客訪談 (Interview)

直接指定類型

# 撰寫公司能力
npm run write-company

# 撰寫競品分析
npm run write-competitor

# 撰寫訪談記錄
npm run write-interview

互動式引導特性

智能提示

根據格式要求動態生成問題
提供範例參考
即時驗證輸入內容

自動驗證

公司能力：檢查量化數據、具體證據
競品分析：驗證價值元素完整性
訪談記錄：確認 JTBD 四要素齊全

格式化輸出

自動生成符合規範的 Markdown 文件
包含必要的章節結構
添加格式提示與說明

與 BrandAnalysis Skill 整合

生成的文件會直接寫入 BrandAnalysis Skill 的對應資料夾：

BrandAnalysis/
└── inputs/
    ├── company_aspects/     ← 公司能力文件
    ├── competitors/         ← 競品分析文件
    └── interviews/          ← 訪談記錄文件

完成撰寫後，即可直接使用 BrandAnalysis Skill 的分析指令：

# 分析顧客需求
npm run analyze-customer -- -f inputs/interviews/

# 掃描競品
npm run scan-market -- -f inputs/competitors/ --yes

# 分析公司能力
npm run self-survey -- --description inputs/company_aspects/

撰寫技巧提醒

公司能力

✅ 好的範例：「擁有 15 年 的調香經驗」、「獲得過 iF 設計獎」 ❌ 避免：「我們是非常專業的團隊」

競品分析

✅ 好的範例：「提供超過 10 萬款 香水的完整資料庫」 ❌ 避免：「非常領先」、「效果顯著」

訪談記錄

✅ 好的範例：「每當下班回到家，感覺整天的壓力快炸開時...」 ❌ 避免：「這個味道還可以」

安裝與設置

# 安裝依賴
npm install

# 啟動工具
npm start