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 都能直接读取、无需再“翻译”的公司知识库。

最适合的使用场景和用户

当你需要把一家公司“as code”地搭建或重组时，可以使用 arquiteto-de-empresa skill：把战略、市场、财务、销售、营销、产品、运营、技术、人才、法务和治理放进同一个相互链接的结构中。它适用于早期创业设计、商业模式文档化、内部公司 wiki、AI 可读的运营系统，以及用于 Strategic Planning 的 arquiteto-de-empresa 场景——尤其是那些需要让决策随时间可追溯的团队。

它和普通 prompt 有什么不同

普通 prompt 可能会生成一份很长的商业计划书。这个 skill 则会引导你完成分阶段访谈，并把答案落成文件：每个 .md 对应一个概念，使用受控的 type 值、相对链接、保留的 index.md 和 log.md，以及确定性的辅助脚本。它的关键差异不只是提供商业建议，而是提供一种可重复使用的文档格式：可以 lint、索引、提交到 Git，并被其他 agents 继续扩展。

采用前需要考虑的事项

如果你愿意按阶段回答问题，这个 skill 的效果最好。它不适合用来快速生成一页 pitch deck、替代法律建议、承诺财务结果，或在没有创始人输入的情况下产出一套“完成版”公司战略。部分文件夹和文件名采用葡语风格，而 skill 语言是 English，因此团队最好尽早决定：是保留原始结构，还是本地化命名规范。

如何使用 arquiteto-de-empresa skill

arquiteto-de-empresa 安装与仓库检查

使用以下命令安装：

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

然后查看源路径：

c-level-advisor/skills/arquiteto-de-empresa

先阅读 SKILL.md，了解角色设定、触发条件、运行规则和 12 阶段流程。接着检查 references/phase_playbook.md、references/okf_conformance.md 和 references/type_vocabulary.md；这些文件定义了 agent 应该问什么、Markdown bundle 必须如何组织，以及哪些 frontmatter type 值是有效的。在生成真实公司文件之前，先预览 assets/frontmatter_template.md、assets/index_template.md 和 assets/log_template.md。

哪些输入能带来更好的输出

arquiteto-de-empresa 的使用方式在第一条请求就提供足够业务背景、能够启动 Phase 0 时效果最好。建议包含阶段、商业模式、行业、司法辖区、客户、现有资产，以及期望输出位置。

较弱的 prompt：

“Help me structure my startup.”

更强的 prompt：

“Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps small clinics reduce missed appointments. Stage: MVP with 5 pilot customers. Model: monthly subscription. Need the first phases only: discovery, foundation, strategy, and market. Ask me questions in small blocks, mark unknowns as [ASSUMPTION], and generate conformant Markdown files with relative links.”

这样能提升结果质量，因为 skill 可以选择正确阶段，避免过早展开细节，并创建符合 OKF 规则的文件。

完整 OKF bundle 的推荐工作流

从 Phase 0 discovery 开始，然后按顺序推进 12-phase playbook。每个阶段中，让 agent 提出 3–5 个问题，确认创始人的回答，生成概念文件，更新文件夹中的 index.md，并向 log.md 添加一条决策记录。除非你只需要一个粗略原型，否则不要要求 agent 一次性输出所有阶段；这个 skill 的设计目标是先访谈再写作，从而减少凭空编造的战略内容。

用于战略规划时，按决策顺序推进各阶段：foundation、strategy、market、financial model、sales、marketing、product、operations、tech、people、legal 和 governance。对尚未解决的判断保留 [ASSUMPTION] 标记，让 bundle 成为规划系统，而不是制造虚假确定性的工具。

使用辅助脚本

仓库中包含一些 Python 工具，可以让输出更可靠。使用 scripts/scaffold_bundle.py 创建骨架，用 scripts/okf_linter.py 检查一致性，用 scripts/index_generator.py 重新生成 index.md 中的概念表。这些脚本以标准库为主，并支持 Git 工作流：生成、检查 diff、lint，然后 commit。即使你的 agent 是手动创建文件，也应在把 bundle 视为权威版本之前运行 linter。

arquiteto-de-empresa skill 常见问题

arquiteto-de-empresa 只适合新公司吗？

不是。它的框架围绕“从零搭建一家公司”展开，但也可以用来记录一家已有公司，尤其是当知识分散在文档、电子表格、聊天记录和创始人记忆中时。对于已经运营的业务，先告诉 agent 哪些内容已经存在，并要求它分别标记遗留事实、假设和缺失证据。

它和商业计划书生成器有什么不同？

商业计划书生成器通常产出一份叙事型文档。arquiteto-de-empresa skill 产出的是 OKF knowledge graph：大量小型 Markdown 概念文件，带有一致的元数据和链接。因此它更适合长期维护、AI retrieval、Git diffs 和跨职能规划。如果你只需要一份面向投资人的精美 PDF，它反而没那么方便。

初学者需要先理解 OKF 吗？

不需要，但应该理解它的运行思路：每个概念一个文件、类型化 frontmatter、相关文件之间互相链接，以及一份决策日志。在深度使用前阅读 references/okf_conformance.md，可以避免常见错误，例如把多个概念合并到一个文件中，或使用不一致的 type 标签。

什么时候不应该使用这个 skill？

不要把它当作法律、税务、会计或受监管行业专业审查的替代品。如果团队无法回答基本 discovery 问题、目标只是品牌文案，或需要在没有安全执行环境的情况下处理机密财务建模，也应避免使用。这个 skill 用来结构化决策；它本身不会验证市场事实是否真实。

如何改进 arquiteto-de-empresa skill

用更强的上下文提升 arquiteto-de-empresa 结果

最有杠杆的改进是提高输入质量。提供真实约束：预算、runway、地理范围、目标客户、销售动作、定价假设、团队能力、技术栈、监管暴露和现有文档。要求 agent 在每个概念文件中区分 “known”、“assumed” 和 “to validate” 部分。这样 OKF bundle 才能服务于战略规划，而不只是描述性文档。

需要警惕的常见失败模式

注意文件被过度压缩、缺少 frontmatter、type 值无效、相对链接薄弱，以及 index.md 页面没有反映实际文件夹内容等问题。另一个常见问题是：当创始人尚未提供证据时，文案却使用过度自信的商业表述。应要求保留 [ASSUMPTION] 标记，并在重大决策发生变化时更新 log.md。

在首版 bundle 生成后继续迭代

第一轮完成后，像审视产品 backlog 一样审视这个 bundle。可以问：哪些概念太大？哪些判断缺少证据？哪些决策需要备选方案和理由？哪些链接能帮助未来的 agent 从战略导航到财务、产品或运营？然后要求 skill 拆分过大的文件、补充缺失的概念链接、重新生成索引，并把变更记录到决策日志中。

为你的组织扩展这个 skill

团队可以通过添加公司专属模板、司法辖区 checklist、行业词汇和验证关卡来改进 arquiteto-de-empresa。核心 OKF 规则应保持稳定：每个文件一个概念、必填 type、相对链接、保留 index.md 和 log.md，以及基于脚本的检查。如果你本地化文件夹名称或新增概念类型，请更新 references/type_vocabulary.md，确保未来的 agents 仍能保持一致。