Communitygithub.com

7Alex4/build-prospect-dossier

開源 Black Flower 框架,用於基於證據的高階潛在客戶檔案,搭配嚴謹的 TypeScript 渲染器。

build-prospect-dossier 是什麼?

這個技能提供了一個完整的、開源的 Black Flower 框架,用於建立以證據為主導的高階潛在客戶創意提案檔案(dossier)。它嚴格區分事實、策略解釋與創意提案,強制使用真實且來源可追溯的素材(如正式影像、授權圖片),並禁止虛構任何資訊。此技能主要透過 TypeScript 渲染器運作,支援 Claude Code、VS Code、Cline 等平台,可產生 2000×1414 像素的 PNG 頁面與 A4 橫向 PDF。其核心工作流程包含:解析簡報、調查研究、撰寫策略診斷、提取品牌語法、建構敘事架構、組合頁面、渲染與最終驗證。此技能確保最終產出物是客戶可直接使用的提案,而非裝飾性的簡報或偽裝成藝術指導的顧問報告。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add 7Alex4/build-prospect-dossier

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

建立潛在客戶檔案

建立一份經過研究的 Black Flower 創意提案,其中策略與真實物件、證據、文化參考、廣告場景和執行細節交替出現。請勿產出帶有虛構策略的裝飾性簡報,或偽裝成藝術指導的顧問報告。

預設情況下,直接產出完整且可供客戶使用的結果,無需提問。僅需公司名稱加上檔案請求即可開始。當使用者提供觀點和影片想法時,將其視為權威依據;若未提供,則推斷出最合理且可捍衛的觀點。

不可協商的合約

  • 基於證據工作。絕不虛構日期、產品、創辦人、能力、客戶、引言、市場事實、獎項、地點、參考資料或品牌意圖。
  • 在工作筆記中明確區分事實、觀察、策略詮釋和創意提案。
  • 當工作有提供範例時,僅將其用於理解結構,絕不將其作為可重複使用的客戶特定顏色、動機、隱喻、文案或圖片的來源。
  • 預設使用真實影像,並記錄其來源、權利基礎和分發範圍。Provided 和 official 描述的是來源,而非使用許可。Alex 的 Black Flower 所有者簡報授權創意生成,但每個檔案必須以授權者和可追蹤的參考資料具體落實此許可。僅有個人檔案名稱絕不構成生成授權。
  • 確保每張選用的影像都能證明、戲劇化或闡明某個具體主張。拒絕通用的氛圍影像。
  • 使用 Black Flower Creative House 作為標準工作室身份,並以 BlackFlower 作為其可見簽名。Nexaia 可作為技術維護者,但絕不能作為潛在客戶檔案上可見的作者。
  • Alex 的 Black Flower 工作預設使用 frameworkProfile: "black-flower"。僅在擁有完整的 generativeAssetsAuthorization 區塊時,才將 generativeAssets 設定為 "authorized"。對於此開源技能的外部使用者,要求他們提供自己的明確授權。
  • 讓 45–65% 的頁面以影像為主,目標為 55%。計算來源混合時,計算每個實際渲染了至少一個實質投影片媒介的頁面,無論其宣告的視覺意圖為何。這些視覺頁面中,至少 60% 必須使用真實、官方、紀錄片、已授權或提供的素材。不超過 40% 可包含生成式素材。標誌、圖案、紋理或裝飾性 SVG 不計入。
  • 絕不將生成的素材註冊為證據、精確產品、已識別人物、螢幕截圖、文件、檔案或品牌身份。僅生成創意投射,然後在需要時合成已清除的精確素材。
  • 最多使用兩張真正必要的圖表頁。介紹之後,連續放置不超過兩個以文字或系統為主導的頁面。
  • 為每個頁面指定明確的視覺意圖。缺少影像是有意的排版決定,絕不是以卡片、節點、箭頭、儀表、藥丸或抽象幾何圖形作為回退方案。
  • 每頁保持一個主導想法,通常不超過三個內容區塊。
  • 輸出為 2000 × 1414 像素的 PNG 頁面和一個 A4 橫向 PDF。
  • 保留可編輯的原始專案檔案。在雜湊字體合約中宣告每個最終字體角色及其 400/700 字重。僅在相同的作業系統、Chromium 版本和已授權的本地字體檔案下,才能保證像素級精確渲染。
  • 當內容不完整時,將 meta.stage 保持在 draft。在最終驗證、完整渲染、審計和交付之前,將其設定為 final。
  • 為每個最終的實質可見欄位提供明確的 ClaimRef。使用相對於其投影片的路徑,例如 title、columns[0].body 或 metrics[0],絕不使用 slides[0].title。主張文字必須解析到精確的可見目標;指標主張必須包含其數值和標籤。
  • 將顯示的聯絡人網站視為具有精確 ClaimRef 的實質文案。將影像替代文字、幀編號、索引和時間碼排除在主張覆蓋範圍之外,但將它們包含在佔位符和禁用詞掃描中。
  • 有意地分類每個主張。絕不要為了通過驗證而應用一概而論的轉換,將所有可見文案標記為 proposal。
  • 在 Black Flower 設定檔中,工作室身份為必填項,並固定為上述標準身份。在明確的中性設定檔中,工作室身份保持可選,且絕不能虛構或給予空的版面插槽。
  • 在最終故事板中,每個影格必須使用本地批准的圖片。遠端 HTTP 素材和可見的佔位符記號是嚴重失敗。
  • 也要掃描渲染的主題字串,包括標誌回退、字標替代文字、運行頁首和每個主題圖片的替代文字。
  • 將每個圖片和主題素材註冊到檔案素材註冊表中,並附上其來源、權利基礎和允許的分發範圍。未註冊或未清除的素材是嚴重失敗。
  • 在交付前運行證據、內容、視覺和技術關卡。僅成功建置不等於完成。

按階段閱讀參考資料

僅讀取當前階段所需的檔案,但需完整讀取每個選定的檔案。

階段必要參考資料
Black Flower 身份與視覺合約references/black-flower-profile.md
輸入與研究references/research-and-evidence.md
策略角度與平台references/strategy-framework.md
頁面數量與敘事順序references/narrative-architecture.md
品牌語法、標誌、字體、顏色、動機references/visual-system.md
圖片獲取與處理references/image-direction.md
客戶面向寫作references/copy-system.md
頁面構成references/slide-blueprints.md
專案創建與渲染references/production-workflow.md
最終驗證references/quality-gates.md

在推導系統或在變體之間做選擇時,讀取 references/method-synthesis.md。它僅包含通用的方法規則。

現有來源檔案分支

當輸入包含 Canva 匯出檔、PDF、先前的檔案或未排序的頁面圖片時,在進入標準工作流程前先進行審計:

  1. 盤點每個來源檔案並保留未經修改的原始檔;
  2. 必要時將 PDF 頁面渲染為圖片;
  3. 對頁面進行自然排序並生成聯繫表;
  4. 以全解析度檢查每個頁面;
  5. 記錄畫布、錨點、色盤角色、字體角色、圖片角色、背景狀態、動機、頁面標記和重複的主版;
  6. 繪製每個頁面的修辭任務,僅提取理解結構所需的簡短標籤;
  7. 標記重複、佔位符、內部註釋、錯誤連結、不支援的主張、不可讀的影格、薄弱的結尾和權利不明確之處;
  8. 為每個頁面建立 保留 / 重建 / 移除 的決定;
  9. 保留來源的推理和經過衡量的系統,但不重新分發專有的文案或素材;
  10. 返回標準的簡報、證據、策略、實施和品質保證工作流程。

如果來源是使用者提供的檔案,則將來源特定的鑑識工作保留在任務本地。可重複使用的參考資料必須僅包含自主且通用的規則。

工作流程

1. 在不阻塞的情況下解析簡報

立即建立 brief.yaml。記錄:

  • 框架設定檔:預設情況下,Alex 使用 black-flower,僅在明確要求時使用 neutral;
  • 工作室:Black Flower 設定檔中為 Black Flower Creative House 和可見簽名 BlackFlower;
  • 公司、品牌、產品或服務;
  • 決策者和受眾(如果已知);
  • 使用者提供的角度、限制、影片、參考資料和期望的頁面數量;
  • 角度狀態:fixed、adaptable 或 open;
  • 輸出語言和 Black Flower 身份,或僅為明確的中性設定檔設定可選的工作室身份;
  • 分發模式:私人探勘、客戶批准的工作或公開發布;
  • 關係狀態:獨立提案、客戶批准或委託製作;
  • 生成式素材:對於 Alex 的 Black Flower 框架,僅在包含 status、authorizedBy 和持久的 reference 時才為 authorized;否則為 forbidden,除非使用者明確授權;
  • 廣告活動模式:focused-opportunity 或 campaign-platform,加上將擁有自己頁面的確切影片路線數量;
  • 來自主動專案指示的禁止客戶面向用詞;
  • 假設和缺失的輸入;
  • 目標結果:會議、創意對話、提案或製作委託。

將使用者提供的特定角度分類為 fixed,將方向性領域分類為 adaptable,將沒有角度分類為 open。固定的角度保持為根本;候選工作可以強化其表達,但不能取代它。如果缺少角度,在研究後推斷它。如果缺少影片想法,僅在公司與主張確實需要時才建立影片概念。如果缺少素材,使用 references/research-and-evidence.md 中的回退階梯;除非無法識別公司本身,否則不要停止。

2. 創建生產工作區

使用捆綁的初始化器創建工作,或將 assets/dossier-engine/ 複製到新的專案目錄。保持技能套件不變。公開的初始化器預設為 neutral;Alex 的工作必須明確傳遞 --profile black-flower。

使用此工作結構:

project/
├── brief.yaml
├── research/
│   ├── evidence.csv
│   ├── claim-map.csv
│   ├── observations.md
│   └── source-notes.md
├── assets/
│   ├── raw/
│   ├── processed/
│   └── asset-ledger.csv
├── strategy/
│   ├── diagnosis.md
│   ├── platform.md
│   └── page-map.md
├── src/content/
│   ├── brand.ts
│   ├── evidence.ts
│   └── deck.ts
├── qa/
├── output/
│   ├── slides/
│   ├── contact-sheet.png
│   ├── dossier.pdf
│   ├── render-report.json
│   └── render-report.sha256
└── delivery/
    ├── prospect/
    ├── author/
    └── public/        可選,僅在請求並清除後使用

遵循 references/production-workflow.md 了解指令和檔案合約。

3. 研究公司並獲取證據

在命名領域之前先進行研究。優先使用當前的主要來源:官方網站、新聞編輯室、媒體資料包、產品頁面、官方社交帳號、年度資料、註冊資訊和第一方訪談。使用獨立行業或信譽良好的編輯來源進行背景資訊和驗證。

為每個有來源支持的事實或觀察建立一個證據列,然後為每個最終客戶面向的陳述建立一個主張地圖列。儲存精確的可見措辭、輸入的內容路徑、證據 ID 和主張類別。為每個標誌、產品圖片、螢幕截圖、檔案、肖像、參考資料或授權照片建立一個素材列。

捕捉實際的溝通基準:

  • 首頁和關鍵產品或服務頁面;
  • 當前的社交媒體格線或近期貼文;
  • 產品範圍、包裝、地點、流程、人員或介面;
  • 品牌歷史和當前商業時刻;
  • 可識別的代碼、形狀、材料、顏色、短語和行為;
  • 一到三個相關的競爭對手或鄰近參考資料。

不要使用搜尋摘要作為證據。不要依賴可能已變更的事實的記憶。

4. 準備身份素材

盡可能獲取官方的向量標誌。保留未經修改的原始檔,然後建立透明的淺色和深色單色變體。絕不拉伸、重繪、裁剪或悄悄更改標記。

準備:

  • logo-original.svg 或最高品質的官方點陣圖;
  • 帶透明背景的 logo-dark.png 和 logo-light.png;
  • 可選的僅符號變體;
  • 僅在使用者或專案提供時才使用工作室標誌變體;
  • 經過測試的潛在客戶歸屬,以及可用的工作室歸屬,並附上光學間距和真實的關係標籤。

不要將客戶或工作室標記捆綁到此開源技能中。將它們保留在工作本地。

5. 撰寫策略診斷

從證據中解決這些問題:

  1. 為什麼是現在,或者當沒有時限性事件時,為什麼這件事情長期重要?
  2. 必須尊重哪些現有資產?
  3. 存在哪些可見的認知或溝通差距?
  4. 必須拒絕哪些顯而易見的創意捷徑?
  5. 什麼獨特的真相可以承載一個更大的故事?
  6. 什麼人類、文化或商業緊張關係使其重要?
  7. 什麼轉變將真相變成一個積極的承諾?
  8. 什麼平台短語可以組織許多執行方案?
  9. 什麼首次啟動最能證明平台的價值?

使用 references/strategy-framework.md。對於 open,至少產出三個候選平台。對於 adaptable,產出三個相容的詮釋。對於 fixed,在不改變其含義的情況下,產出三個供應根基的執行方案或口頭表達。為它們評分,保留一個,並將被拒絕的選項和原因保存在 strategy/diagnosis.md 中。

6. 提取品牌語法

從這家公司本身建立一個新的視覺語法,而不是從範例中提取。記錄:

  • 封面、內頁和最終背景機制;
  • 墨水、支持和功能強調色;
  • 標題、內文、顯示數字和說明文字的字體角色;
  • 一個源自真實品牌或產品代碼的建築性動機,或在沒有獨特物件時的記錄在案的排版/網格系統;
  • 圖片裁剪和去背邏輯;
  • 頁面標記、章節標記、微標題和組合標誌的行為;
  • 安全區和密度限制。

將潛在客戶特定的語法保留在 references/black-flower-profile.md 中定義的持久 Black Flower 編輯框架內。潛在客戶提供物件、圖像、材料、色盤和動機。Black Flower 提供作者身份、節奏、層級和生產邏輯。

使用經過測量的顏色和官方素材。如果品牌字體不可用或未經授權,根據字形和情緒選擇開源等效字體,並將其標記為替代字體。

7. 選擇檔案設定檔並繪製每個頁面

預設使用 18-20 頁的標準設定檔。對於具有緊湊執行證明且沒有過大影片章節的重點機會,使用 15 頁。如果廣告活動規模較大,則將其拆分為第二卷,而不是削弱 20 頁的上限。

在撰寫完整文案之前建立 strategy/page-map.md。為每個頁面記錄:

  • 頁碼和系列;
  • 在論證中的目的;
  • 單一要點

…

[因原文截斷而截斷]

相關技能