Foundation

Foundation 技能

开源 Agent 技能，能完成可行性顾问的工作：估算市场规模、对标竞争对手、编制财务研究、优化定价，然后撰写商业计划和路演演示文稿。它们运行在你自己的 AI Agent 中（Claude、Codex、Gemini CLI、Cursor 等）。这些技能由 Foundation 背后的团队打造。

_{▶ 48 秒了解 Foundation：一个示例咖啡馆项目，从成本到商业计划，以及测试该项目的 AI 助手。}

为什么要做这个项目

询问通用 AI 助手你的商业创意是否可行，它会写出一份听起来像可行性研究的内容。问题隐藏在细节中：

• 数学是猜出来的。 大模型不是计算器。AI 撰写的计划中的 NPV、IRR、投资回收期和盈亏平衡数据往往不准确，而且文档中没有任何内容能告诉你哪些数据有误。
• 假设不透明。 “38,000 英镑的装修费用”是怎么来的？贷款方会提出这个问题，而“AI 说的”并不是答案。
• 各部分对不上。 团队部分说有 5 名员工，工资项却按 4 人计算，市场分析章节使用的数字又和路演演示文稿中的不同。

专业顾问会避免这三类问题。他们会为每项输入注明来源，用真正的财务模型计算数据，并维护唯一且一致的事实版本，供所有文档使用。这些技能教会 AI Agent 用同样的方式工作。

工作原理

这些技能按照合理的方式拆分工作：

• Agent 负责分析师的工作： 访谈创始人，调研成本、价格和竞争对手，选择合适的结构，标注每个数字的来源，并撰写内容。
• 确定性引擎负责计算： Foundation 是一款可行性研究 Web 应用，配备经过测试的计算引擎。它根据输入计算投资、运营成本、收入增长、利润、现金流、NPV、IRR、投资回收期、盈亏平衡点和 SaaS 指标。当你的 Agent 连接到 Foundation 后，输出中的每个财务数字都来自该引擎。Agent 自己绝不会进行计算。

这些技能也可以在没有 Foundation 账户的情况下使用。Agent 仍会进行调研，并为每项输入标注来源，绝不编造财务结果。随后，它会提供一个 foundation-project.json 文件。将该文件导入 Foundation（Projects → Import），即可生成计算后的研究报告。

技能

技能	功能
feasibility-analyst	将你的业务描述转化为完整的可行性研究：业务类型、成本类别、资本与运营成本、人员配置、收入模式和财务假设，并为每项输入标注来源。然后读取研究结果，为你撰写一份包含风险和关键影响因素的可行或不可行备忘录。
market-research	自下而上估算市场规模（TAM、SAM、SOM），并从上而下进行交叉验证。根据公开来源分析竞争对手，并填写「竞争对手 × 功能」对比表。检查你的收入计划是否需要占据超出实际可赢得份额的市场份额。如果价格未公开，则为你准备一套联系资料，供你自行询价。
pricing-optimizer	找出你的成本底线、竞争对手价格和客户价值之间的价格区间。设计三到五种不同的定价方案，明确设定销量假设，通过引擎测试每种方案，并推荐一种方案及其验证计划。
business-plan-writer	撰写达到贷款机构和投资者标准的商业计划书，并生成 Word 文件（.docx）。财务表格、图表和情景分析均根据引擎输出生成，因此无需手动重新输入任何数字。
pitch-deck-writer	制作 PowerPoint 文件（.pptx）格式的路演演示文稿：每张幻灯片传达一个观点，以结论作为标题，包含由引擎计算的财务幻灯片，并在交付前逐张检查视觉效果。

以上五项技能都遵循 CONVENTIONS.md 中列出的相同规则：

• 每项输入都附有来源标签：创始人、报价、基准或估算。
• Agent 只会一次性询问无法通过研究获取的信息。
• 写作遵循一份基于维基百科 AI 写作的迹象的指南：句子简洁 明了，不夸大其词，不使用长破折号。
• 如需使用品牌模板或更复杂的设计，Word 和 PowerPoint 文件可以再通过你所在环境自带的文档工具处理，并使用脚本检查处理过程中数字是否发生变化。

安装

任何支持技能的 Agent（Claude Code、Codex、Gemini CLI、Cursor 等）：

npx skills add mamarexa/foundation-skills

或者手动复制所需的技能文件夹：

Agent	技能存放位置
Claude Code	~/.claude/skills/（所有项目）或 .claude/skills/（单个项目）
Claude.ai / Claude Desktop	将技能文件夹压缩成 ZIP，然后依次选择 Settings → Capabilities → Skills → Upload
Codex	~/.codex/skills/
Gemini CLI	~/.gemini/skills/ 或 .gemini/skills/
Cursor	~/.cursor/skills/ 或 .cursor/skills/

Word 和 PowerPoint 技能需要安装含有 python-docx、python-pptx 和 matplotlib 的 Python。Claude 的代码沙盒已预装这些依赖。在其他环境中，请运行 pip install python-docx python-pptx matplotlib。

连接 Foundation（可选，推荐）

1. 在 getfndtn.com 创建免费账户。
2. 将 https://getfndtn.com/api/mcp 添加到你的 Agent，作为远程 MCP 服务（在 Claude 中： 依次选择 Settings → Connectors → Add custom connector）。然后使用你的 Foundation 账户登录。
3. 让你的 Agent 撰写可行性研究。它会找到 Foundation 工具并针对你的实际项目开展工作，数字也会与你在应用中看到的一致。

Claude、ChatGPT、Codex、Cursor、Gemini CLI、Antigravity 和 VS Code 的分步设置说明见 Foundation 文档。

试试看

“我想在利兹火车站附近开一家特色咖啡馆，大约有 30 个座位，明年春天开业。这个项目可行吗？我需要筹集多少资金？”

“估算英国牙科诊所排班软件的市场规模，并对主要竞争对手进行基准分析。”

“把我的 Foundation 项目整理成一份用于银行贷款的商业计划书，然后再制作一份 12 页的演示文稿。”

贡献

本仓库会随着使用不断完善。最有价值的贡献包括：

• 附带来源的基准数据： 你所在行业或国家的成本比例、启动成本范围、工资、雇主薪资成本、租金和税率。当地数据对美国和英国以外的创业者最有帮助。
• 从业者的纠正： 如果这是你的日常工作，而某个步骤有误或有所遗漏，请告诉我们实际操作方式。
• 测试用例： 一份真实的业务描述，以及一份优质研究应包含的内容。

有价值的贡献也会回馈到 Foundation 应用中，例如改进默认类别和基准范围。请参阅 CONTRIBUTING.md 了解规则。简而言之：每个数字都必须有一个你愿意出示给贷款方的来源。

本仓库与 Foundation 应用中的 skills/ 文件夹会自动双向同步，因此这里合并的拉取请求也会显示在应用中（作为经过审查的 PR，而非静默合并），无需任何人手动复制文件。

测试

pip install python-docx python-pptx matplotlib
python tests/test_scripts.py

tests/fixtures/ 中的夹具项目是一家示例咖啡馆。其事实文件是 Foundation 引擎的真实输出。

许可证

MIT。贡献即表示你同意以相同方式授权你的贡献，包括将其用于 Foundation。