Skip to content

hhx465453939/HelmForge

Repository files navigation

HelmForge — Forge your enterprise. Take the helm.

⚓ HelmForge

Forge your enterprise. Take the helm.

企业掌舵者的 AI 经营驾驶舱 · Forge 三部曲 · 第三部

License: PolyForm-NC Ethics: Enterprise Platforms Skills Contribute Status


📖 HelmForge 是什么

HelmForge 是 Forge 三部曲 的收官之作:

  • 🛠️ CodeForge — 开发者 → 开源贡献引擎
  • 🧬 VitaForge — 研究者 → 生命科学引擎
  • HelmForge(本项目)— 掌舵者 → 企业经营引擎

它是面向 CEO / CFO / COO / 部门负责人 / 创业者 / 家族传承人 / 企业战略与经营团队 的 AI 经营副驾驶。一个入口(/executive-consultant 主调度)智能路由 18 个专业 skill,覆盖五大板块:

  • 🧭 战略决策 — 战略咨询 / 商业模式 / 地缘宏观 / 深度调研
  • 💰 财务预算 — 三大报表管理 / 预算编制 / 电商财务
  • 🏛️ 组织治理 — 高级行政秘书 / 对外谈判 / 全球法律顾问
  • 📦 交付展示 — Office 文档 / PPT 模板 / 代码生成 PPT / HTML 演示 / PDF 提取
  • 🔧 治理引擎 — 多 skill 联动设计 / 五镜像部署 / 单 skill 质量门控

💡 核心差异化

# 特性 说明
1 驾驶舱式统管 一个主调度路由 18 个专业 skill,不再散装拼 prompt
2 财商融合 全新设计 finance-manager + budget-architect + strategy-cfo,补齐财务视角
3 宏观地缘 内置 geo-sentinel(地缘政治 + 宏观新闻预测),服务出海与宏观风险决策
4 四镜像实质部署 Claude / Codex / Antigravity / OpenClaw 系(WorkBuddy / 龙虾)+ 通用 Agent 一句话
5 永久非商业 PolyForm-NC 保护项目特殊性,配套企业经营 ETHICS 八条红线

🚀 一键部署

📋 完整部署指南docs/deployment-guide.md — 决策树、每宿主详细说明、在线 Agent 内容注入方案、Agent 自检 Prompt。

方式一:按宿主一键部署(推荐)

找到你的宿主,复制对应的 prompt 粘贴给 Agent,Agent 会自动 clone 仓库并执行部署

🅰️ Claude Code 用户

帮我把 https://github.com/hhx465453939/HelmForge 部署为 HelmForge 技能包(仅 Claude Code 镜像)。

要求:
1. git clone https://github.com/hhx465453939/HelmForge.git 到临时目录;
2. 运行 deploy/deploy.sh --yes --only claude(macOS/Linux)或 deploy/deploy.ps1 -Yes -Only claude(Windows);
3. 部署完成后告诉我部署路径和下一步怎么验证(重启 claude 后输入 / 看到 executive-consultant)。

红线:不修改 LICENSE / ETHICS.md;不商业化。

🅱️ Codex CLI 用户

帮我把 https://github.com/hhx465453939/HelmForge 部署为 HelmForge 技能包(仅 Codex 镜像)。

要求:
1. git clone https://github.com/hhx465453939/HelmForge.git 到临时目录;
2. 运行 deploy/deploy.sh --yes --only codex(macOS/Linux)或 deploy/deploy.ps1 -Yes -Only codex(Windows);
3. 部署完成后告诉我部署路径和下一步怎么验证。

红线:不修改 LICENSE / ETHICS.md;不商业化。

🅲 Antigravity / Gemini CLI 用户

帮我把 https://github.com/hhx465453939/HelmForge 部署为 HelmForge 技能包(仅 Gemini/Antigravity 镜像)。

要求:
1. git clone https://github.com/hhx465453939/HelmForge.git 到临时目录;
2. 运行 deploy/deploy.sh --yes --only gemini(macOS/Linux)或 deploy/deploy.ps1 -Yes -Only gemini(Windows);
3. 部署完成后告诉我部署路径和下一步怎么验证。

红线:不修改 LICENSE / ETHICS.md;不商业化。

🅳 WorkBuddy / OpenClaw / 龙虾 用户

帮我把 https://github.com/hhx465453939/HelmForge 部署为 HelmForge 技能包(仅 OpenClaw 系镜像,适用于 WorkBuddy / OpenClaw / 龙虾)。

要求:
1. git clone https://github.com/hhx465453939/HelmForge.git 到临时目录;
2. 运行 deploy/deploy.sh --yes --only agents(macOS/Linux)或 deploy/deploy.ps1 -Yes -Only agents(Windows);
3. 部署完成后告诉我部署路径,以及怎么在 WorkBuddy/OpenClaw 里验证(描述经营场景,看是否触发 finance-manager 等 skill)。

红线:不修改 LICENSE / ETHICS.md;不商业化。

🌐 GPT / 豆包 / Claude.ai / 元宝 / Kimi Web 用户(在线 Agent)

浏览器里的对话式 AI 没有本地文件系统,不需要跑脚本。改走内容注入方案:

帮我把 https://github.com/hhx465453939/HelmForge 的 skill 内容加载到当前对话环境。

要求:
1. 从仓库抓取 .claude/skills/executive-consultant/SKILL.md 和 .claude/skills/finance-manager/SKILL.md 的内容;
2. 告诉我这两个 skill 的触发词和输出合同;
3. 接下来的对话中,当我描述经营场景时,请按 executive-consultant 的路由表分诊,调用对应 skill 回答。

红线:不修改原始内容;不商业化;遵循 PolyForm-NC + HelmForge 8 条红线。

📖 更多在线 Agent 方案(Custom GPT / Claude Projects / 豆包智能体)见 docs/deployment-guide.md §E


方式二:通用 Agent 自检 Prompt(不知道自己是哪款宿主时用)

把下面这段完整贴给你的 Agent,它会自动检测环境并执行对应部署:

帮我把 https://github.com/hhx465453939/HelmForge 部署为 HelmForge 技能包。

请先执行以下自检,判断我的宿主环境属于哪一类,然后执行对应部署:

【自检步骤】
1. 你自己是哪一款 Agent?(Claude Code / Codex / Gemini / Antigravity / WorkBuddy / 龙虾 / OpenClaw / ChatGPT / 豆包 / 元宝 / Kimi Web / 其他)
2. 你运行在什么环境?(本地终端 CLI / 桌面 App / 浏览器)
3. 我是否已经把 HelmForge 仓库克隆到本地?

【判定表】
- Claude Code (本地) → 类型 A → git clone + bash ./deploy/deploy.sh --yes --only claude
- Codex CLI (本地) → 类型 B → git clone + bash ./deploy/deploy.sh --yes --only codex
- Antigravity / Gemini CLI (本地) → 类型 C → git clone + bash ./deploy/deploy.sh --yes --only gemini
- WorkBuddy / OpenClaw / 龙虾 (本地桌面) → 类型 D → git clone + bash ./deploy/deploy.sh --yes --only agents
- 浏览器里的 GPT / 豆包 / Claude.ai / 元宝 / Kimi (在线) → 类型 E → 走内容注入,不跑 deploy 脚本

【产出】
1. 判定的类型(A/B/C/D/E)+ 一句话理由
2. 具体到我的 OS(Windows PowerShell 还是 macOS/Linux bash)的部署命令
3. 部署完成后我需要做什么验证
4. 如果是类型 E,告诉我需要哪些文件、Instructions 写什么

【禁止】
- 不要 --yes 一把梭装 4 个镜像,除非我明确说"我全都要"
- 不要跳过环境自检直接给命令
- 不要把类型 E 的内容注入方案当成类型 A/B/C/D 的本地部署来处理

详细部署指南:https://github.com/hhx465453939/HelmForge/blob/main/docs/deployment-guide.md

方式三:手动 Shell 命令(高级用户)

如果你已经 clone 了仓库,可以直接跑 deploy 脚本(点击展开)
# 克隆仓库
git clone https://github.com/hhx465453939/HelmForge.git
cd HelmForge

# macOS / Linux / WSL / Git Bash
bash ./deploy/deploy.sh --yes --only claude          # Claude Code
bash ./deploy/deploy.sh --yes --only codex           # Codex CLI
bash ./deploy/deploy.sh --yes --only gemini          # Antigravity
bash ./deploy/deploy.sh --yes --only agents          # WorkBuddy/OpenClaw/龙虾
bash ./deploy/deploy.sh --yes                        # 全量(4 个镜像)

# Windows PowerShell
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -Yes -Only claude
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -Yes -Only codex
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -Yes -Only gemini
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -Yes -Only agents
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -Yes

完整开关:--yes--target <dir>--only <list>--no-backup--install-entry-docs--force--dry-run。 详见 docs/deployment-guide.md


📊 技能矩阵(18 skill)

一个 /executive-consultant 入口,5 个板块,18 个专业 skill。每个 skill 都有独立的 .claude/skills/<name>/SKILL.md(其它三镜像同名同 MD5)。

🧭 战略决策(4)

命令 一句话定位
/executive-consultant 主调度 + 参谋长增强模式,识别经营场景并路由到下游 skill
/strategy-cfo 🆕 战略财务视角:商业模式 / 资本结构 / 估值区间 / 资本支出优先级
/geo-sentinel 🆕 地缘政治与宏观新闻扫描,输出对经营决策的风险与窗口判断
/deep-research 多 agent 并行深度调研,用于市场 / 竞品 / 政策 / 行业情报

💰 财务预算(3)

命令 一句话定位
/finance-manager 🆕 三大报表健康诊断、关键财务比率、估值方法论(含亏损公司)
/budget-architect 🆕 零基预算 + 滚动预测,自上而下与自下而上双向对齐
/ecommerce-finance 电商单品毛利 / 促销 ROI / 平台佣金分账测算

🏛️ 组织治理(3)

命令 一句话定位
/executive-secretary 高级行政秘书级日程 / 通勤 / 多地行程编排(可接高德地图 MCP)
/external-negotiation-master 站在委托方一侧的对外谈判 / 催款 / 报价 / 话术设计
/global-legal-counsel 顶级总法律顾问:合同 / 诉讼 / 合规 / 跨境风险 / 劳动争议

📦 交付展示(5)

命令 一句话定位
/office-docs PPTX / DOCX / XLSX 的读取、编辑、创建、校验全流程
/editing 以现有 PPTX 为模板做内容替换与布局优化
/pptxgenjs 从零用 PptxGenJS 代码生成 PPTX 演示文稿
/frontend-slides 生成炫酷 HTML 演示(前端向路演 / 发布会 / 内评审风格)
/pdf-reader 用 pdfplumber 提取本地 PDF 文本并落 Markdown

🔧 治理引擎(3)

命令 一句话定位
/loop-engineer 多 skill 联动 package 设计与联动完整性审计
/skill-deploy 融合去重 + 系统级部署 + post-smoothing 四镜像校验
/skill-governor 单 skill 新增 / 升级的规范门控(frontmatter / references / 四镜像同步)

🆕 = HelmForge 全新设计的核心增量(9 已有 + 4 池子复用 + 3 全新 + 2 借用 Forge 姊妹项目


🔌 推荐 MCP(可选)

HelmForge 的核心 skill 全部离线可用(graceful degradation),但接上下列 MCP 后能力更完整。模板见 deploy/mcp-config.template.json

MCP 面向 skill 增强能力
高德地图 MCP (@amap/amap-maps-mcp-server) /executive-secretary 真实通勤时间 / 多地行程路线规划 / 会议地点选址
财经数据 MCP (finance-mcp-server) /finance-manager/strategy-cfo A 股 / 港股 / 美股行情、财报、宏观指标、可比公司数据

配置示例:

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": { "AMAP_API_KEY": "<your-key>" }
    },
    "finance": {
      "command": "npx",
      "args": ["-y", "finance-mcp-server"],
      "env": { "TUSHARE_TOKEN": "<your-token>" }
    }
  }
}

🇨🇳 国内 API 提供商指引:如果你在中国大陆网络环境下使用,参见 docs/cn-api-providers.md — 收录了主流模型 API、地图 / 金融数据源、以及 harness 层网络调优的可用组合。


🎯 典型场景(可直接照抄)

以下四组是 HelmForge 最常见的经营场景。用户只需对 /executive-consultant 说一句人话,主调度会自动串起下游 skill。

场景 1 — 融资路演准备

/executive-consultant  "我要做 A 轮融资路演,帮我准备"

  → /strategy-cfo             商业模式画布 + 资本结构 + 估值区间
  → /finance-manager          三大报表健康诊断 + 关键比率
  → /budget-architect         未来 3 年滚动预测 + 现金流敏感性
  → /deep-research            可比公司 & 可比交易的市场数据支撑
  → /frontend-slides          输出 30 页 HTML 路演 deck(可导 PDF)

场景 2 — 供应商年度合同谈判

/executive-consultant  "关键供应商今年要重签,帮我准备谈判"

  → /external-negotiation-master  BATNA 拆解 + 锚点设计 + 让步阶梯 + 话术
  → /global-legal-counsel         合同条款红线 + 修改建议 + 争议解决条款
  → /geo-sentinel                 供应地的地缘 / 关税 / 出口管制风险扫描
  → /office-docs                  谈判纪要 + 合同新旧版本对比 + 会签追踪

场景 3 — 年度预算编制

/executive-consultant  "明年公司的预算怎么编"

  → /budget-architect     零基预算 + 自上而下战略目标下达
  → /finance-manager      基于历史财报的可行性 sanity check
  → /geo-sentinel         宏观环境假设(GDP / 汇率 / 关键政策窗口)
  → /strategy-cfo         资本支出 & 招募额度的优先级排序
  → /office-docs          输出预算包(Excel 模板 + PPT 汇报稿)

场景 4 — 敏感人事事件升级

/executive-consultant  "两位高管冲突升级,需要战略决策"

  → executive-consultant         切换参谋长增强模式(自身处理决策沙盘)
  → /global-legal-counsel        劳动法 + 股权 + 竞业 + 保密协议风险审视
  → /external-negotiation-master 离职 / 复位谈判话术设计与 BATNA
  → /executive-secretary         隔离沟通节奏 & 关键会面日程编排

更多复合场景(家族信托治理、跨境搬迁、危机公关)见 docs/superpowers/specs/2026-07-04-helmforge-design.md §5。


🍴 Fork 写你自己的 Agent

HelmForge 期望的用法不是"照抄下载",而是"fork 出你自己那把舵"。

推荐流程:

  1. Fork hhx465453939/HelmForge 到你的账号,克隆到本地。
  2. 直接在 .claude/skills/<name>/SKILL.md 里改文案、加你行业的术语与红线。
  3. /skill-governor 起草新 skill;用 /skill-deploy 做四镜像 MD5 同步。
  4. /loop-engineer 检查主调度是否已经把你的新 skill 路由进去。
  5. 在你自己的 fork 里保留 PolyForm-NC;若你把它用于内部生产,请联系 HelmForge 商业授权(见 ETHICS.md §3.2)。
  6. 如果你觉得改动值得回馈上游,参考 CONTRIBUTING.md 提 PR。

个人 / 家族 / 内部评估用途:永远免费(PolyForm-NC)。


🤖 让 Agent 优化 skill 并自动发 PR(进阶)

HelmForge 的招牌玩法 —— Agent Self-Evolution。你的 agent(Claude / GLM / DeepSeek / Gemini …)在使用某个 skill 时发现瑕疵,可以就地调用 /skill-governor 起草改写方案,/skill-deploy 完成四镜像同步,然后 fork 仓库、提交 conventional commit(带 AI trailer)、gh pr create 走 HelmForge 的 PR 模板 —— 全程 human-in-the-loop(你审阅方向与最终 PR)。

完整流程与可直接复制的 prompt 见 CONTRIBUTING.md Path C · Agent Self-Evolution。三条贡献路径:

  • Path A · 报告问题 / 建议新 skill(不需要写代码)
  • Path B · 手动 PR 改进已有 skill(熟悉 Git 工作流)
  • Path C · Agent 自进化 —— 让 AI 自己起草改写并提 PR,你审阅(推荐

🪞 多镜像部署

镜像平台 目录结构 入口文档 状态
Claude Code .claude/commands/*.md + .claude/skills/*/ CLAUDE.md ✅ 完整
Codex CLI .codex/skills/*/ AGENTS.md ✅ 完整
Antigravity(原 Gemini) .gemini/skills/*/ GEMINI.md ✅ 按 Gemini 格式完整
OpenClaw / WorkBuddy / 龙虾 .agents/skills/*/ OPENCLAW.md ✅ 实质支持
通用 Agent 一句话部署 见本 README

每个镜像的 /executive-consultant 都内置相同的 Package 主调度路由表,由 /skill-deploy post-smoothing 校验;四份 SKILL.md 的 MD5 必须一致(有意分叉需在 PR body 说明)。


📜 License & Ethics

License: PolyForm Noncommercial 1.0.0

详见 LICENSE

  • 非商业使用 / 修改 / 分发:永久免费(个人 / 教育 / 科研 / 非营利 / 内部评估)
  • 源码可见(source available)
  • 未授权商业使用禁止(含 SaaS / 付费服务 / 企业生产部署 / 嵌入商业产品)
  • 🚫 无 Change Date(永久非商业,不转 OSS —— 项目特殊性)
  • 📝 商业授权:另行书面协议(联系方式见 ETHICS.md §3.2)

Ethics: 企业经营八条红线

详见 ETHICS.md。摘要:

# 红线 一句话
1 🚫 反商业贿赂 不设计、不执行任何贿赂、回扣、利益输送
2 🚫 反财务欺诈 不参与财务造假、报表操纵、业绩粉饰
3 🚫 反垄断 不策划价格操纵、市场瓜分、串通投标
4 🚫 反洗钱 不设计资金通道、不规避外汇管制
5 🔒 数据隐私 敏感数据须脱敏,遵守跨境合规
6 ⚖️ 合规边界 不替代律师 / 会计师 / 审计师的正式专业意见
7 🤝 人在回路 重大决策必须人类最终拍板,AI 仅参谋
8 🌱 ESG 鼓励 鼓励负责任、可持续的经营决策

违反红线会立即触发 PolyForm-NC 的 Violations 条款,License 自动终止。


💬 社区

姊妹项目(Forge 三部曲)

项目 定位 仓库
🛠️ CodeForge 开发者 → 开源贡献引擎 PancrePal-xiaoyibao/CodeForge
🧬 VitaForge 研究者 → 生命科学引擎 PancrePal-xiaoyibao/VitaForge
HelmForge 掌舵者 → 企业经营引擎 本项目

🗺️ 开发路线(5 Phase)

Phase 内容 状态
P1 骨架品牌 LICENSE + ETHICS + README 骨架 + 4 入口文档 + deploy 骨架 ✅ 完成
P2 迁移复用 13 个已有 skill → 四镜像 ✅ 完成
P3 新建核心 🆕 finance-manager + budget-architect + strategy-cfo + geo-sentinel ✅ 完成
P4 治理部署 loop-engineer / skill-deploy / skill-governor + 一键部署 ✅ 完成
P5 开源门面 CONTRIBUTING.md + docs/cn-api-providers.md + logo / banner + README polish ✅ 完成

HelmForge logo

HelmForge · Forge your enterprise. Take the helm.

如果这个项目对你有帮助,欢迎 ⭐ Star 支持。