arquiteto-de-empresa

arquiteto-de-empresa skill 概覽

arquiteto-de-empresa 適合用來做什麼

arquiteto-de-empresa 是一個 Company Architect skill，可將創辦人粗略的商業想法轉換成 OKF bundle：一組可版本控管的 Markdown 檔案樹，包含 YAML frontmatter、具型別的概念、交叉連結、index.md 儀表板，以及只追加不改寫的 log.md。它不是產出一次性的商業計畫書，而是透過分階段訪談，把公司具體化為人類與 AI agents 都能讀取的結構化知識。

最適合的使用者與決策情境

這個 skill 特別適合創辦人、chief-of-staff 型營運人員、venture studios、顧問，以及策略規劃團隊；他們需要的是持續演進的公司知識庫，而不只是募資簡報式的敘事。它適用於早期公司設計、商業模式文件化、營運系統建立，以及 “company as code” 工作流程。當你希望把策略、市場、財務、銷售、行銷、產品、營運、技術、人才、法務與治理決策串在同一個 repository 裡時，arquiteto-de-empresa for Strategic Planning 會特別有用。

這個 skill 的差異化之處

主要差異在於結構。這個 skill 依循 12 個階段的 playbook，一次只詢問少量問題，並用受控的 type 詞彙，將每個概念寫成一個獨立的 .md 檔案。這讓輸出更容易在 Git 中比對差異、驗證、建立索引，也更容易被其他 agents 重複使用。內含的 references 與 Python scripts 可支援搭建 scaffold、檢查 OKF 符合度，以及重新產生索引表格。

什麼情況下可能太重

如果你只需要快速 SWOT、landing page brief，或一份短版投資人 memo，就不建議安裝 arquiteto-de-empresa skill。這套方法刻意設計得系統化。它最適合願意分階段回答問題、維護檔案，並把假設視為草稿知識而非最終真相的使用者。

如何使用 arquiteto-de-empresa skill

先安裝並檢視 repository

在 Claude skills 工作流程中，可用以下指令從 repository 安裝：

npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa

如果你的工具不支援這個指令，請複製或引用 c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa 底下的 skill 資料夾。正式使用前，先閱讀 SKILL.md，接著看 references/phase_playbook.md、references/okf_conformance.md 與 references/type_vocabulary.md。也建議先預覽 assets/frontmatter_template.md、assets/index_template.md 和 assets/log_template.md，了解 agent 預期要遵守的檔案契約。

從完整的 discovery prompt 開始

好的 arquiteto-de-empresa usage 應該從脈絡開始，而不是一句模糊的要求。不要只說「幫我打造公司」，請提供 Phase 0 discovery 需要的初始事實：

• 公司想法與客戶問題
• 階段：idea、MVP、operating 或 scaling
• 商業模式：service、SaaS、marketplace、product、hybrid
• 產業、國家與法律管轄地
• 既有名稱、資產、限制與已知假設
• 期望輸出位置，例如 ./my-company-okf

更好的 prompt 會像這樣：「Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps clinics reduce no-shows. We are at MVP stage, have no legal entity yet, and want files suitable for Git. Run Phase 0 first, ask only the necessary questions, mark unknowns as [ASSUMPTION], then scaffold the bundle.」

遵循 12 階段工作流程，而不是一次倒出所有內容

這個 skill 的設計是依序訪談：discovery、foundation、strategy、market、finance、sales、marketing、product、operations、tech、people、legal，以及 governance。請要求 agent 完成一個階段、確認產生的 concepts、更新根目錄的 index.md，並追加 log.md，再進入下一階段。這能避免輸出流於淺層或前後不一致，也能讓策略決策保有可追溯性。

用輔助 scripts 做品質控管

repository 內含 scripts/scaffold_bundle.py、scripts/okf_linter.py 與 scripts/index_generator.py。在 agent 起草內容後，可把它們當作實作輔助工具使用。linter 很重要，因為 OKF 品質取決於細節：每個 concept 都應該是獨立的 Markdown 檔，frontmatter 應包含有效的 type，連結也應形成可用的知識圖譜，而不是一批彼此孤立的文件。

arquiteto-de-empresa skill 常見問題

arquiteto-de-empresa 只適合新公司嗎？

不是。它最擅長從零建立一家公司，但如果你提供現有策略、流程、工具、財務與組織細節，它也能用來文件化既有公司。若是營運中的公司，請要求 skill 區分「current state」、「target state」與 [ASSUMPTION] 項目，避免 bundle 把現況改寫成願景。

它比一般商業計畫 prompt 好在哪裡？

一般 prompt 往往會回傳一份修飾得很完整、但結構扁平的文件。arquiteto-de-empresa 產出的是可瀏覽的知識系統：具型別的 Markdown concepts、保留用途的 indexes、decision logs，以及交叉連結。當你希望未來的 agents 能擷取公司知識、只更新單一 concept 而不用重寫全部內容，或追蹤決策如何隨時間改變時，這一點很關鍵。

使用前需要先懂 OKF 嗎？

不需要，但在信任輸出之前，應該先閱讀 OKF conformance reference。核心規則很單純：每個檔案一個 concept、YAML frontmatter 必須有有效的 type、保留 index.md 與 log.md、concepts 之間使用相對連結，並清楚標示 assumptions。初學者只要遵循分階段訪談，而不是一次要求產生所有檔案，也能把這個 skill 用好。

什麼時候不該使用這個 skill？

當速度比結構更重要、商業內容機密到不適合分享給 AI 環境，或你需要具法律效力的建議時，應該跳過這個 skill。它可以整理 legal 與 governance concepts，但不能取代律師、會計師，或特定管轄地的合規審查。

如何改善 arquiteto-de-empresa skill

產生檔案前，先改善 arquiteto-de-empresa 輸入品質

影響品質最大的槓桿是輸入的具體程度。請提供真實限制：預算範圍、目標客戶、地理市場、創辦人能力、目前 traction、定價假設、銷售動作、法規風險與技術偏好。如果有些資訊未知，就直接說未知。只有當 agent 知道哪些事實缺漏時，這個 skill 的 [ASSUMPTION] 慣例才會真正有用。

避免常見的 OKF 失敗模式

請留意以下問題：一個檔案混入多個 concepts、缺少 type 值、描述過於籠統、相對連結失效，以及策略主張沒有連到市場或財務假設。每個階段後，都可以要求 agent 做一次 conformance pass：「Check every generated concept against references/okf_conformance.md and references/type_vocabulary.md; list fixes before rewriting.」

用決策標準迭代各階段輸出

每個階段結束後，請用「是否有助於決策」來檢視輸出。好的 foundation phase 應該釐清目的、問題、價值觀與假設。好的 finance phase 應該揭露 revenue model、cost structure、unit economics、pricing 與 projections。好的 operations phase 應該產出他人能實際執行的 processes 與 runbooks。如果輸出讀起來像行銷文案，請要求它補上更清楚的取捨、依賴關係與被排除的替代方案。

依你的營運模式擴充這個 skill

若要為你的組織改善 arquiteto-de-empresa，可以加入公司專屬 templates、type vocabulary extensions，或 review checklists，但不要破壞 OKF 的基本原則。例如，受監管的 healthcare startup 可能會加入 compliance evidence fields；venture studio 可能會加入 investment committee status；SaaS team 可能會把 PRDs 連到 roadmap 與 architecture files。所有擴充都應明確寫出來，讓未來的 agents 不需要依賴隱性慣例，也能理解這個 bundle。