heropedia

Claude Code 的 Heropedia 插件

在任何 Claude Code 会话中，直接咨询 324 多位精心打造的专家角色——包括 Warren Buffett、Steve Jobs、Charlie Munger、Linus Torvalds 等。

此插件包含：

• heropedia skill — 在 “ask to...”、“consult ”、“channel ” 等短语出现时触发。在回答前从 Heropedia MCP 获取规范角色提示词，因此回复确实是透过该专家的视角作答，而非模仿其风格。
• .mcp.json — 将 https://www.heropedia.org/mcp 注册为 MCP 服务，以便 Claude Code 调用 getList、getListByHero、getListByRole 和 getDetail。

插件不附带任何数据。所有 324 多个角色都托管在 heropedia.org，并按需获取。

Skills

此插件包含两个共用同一 MCP 服务的 skill：

• heropedia — 单轮“咨询专家”视角。在 “ask Warren Buffett to look at my deck”、“as Steve Jobs, review this page”、“consult Charlie Munger” 等短语出现时触发。获取规范角色提示词，并通过该视角在一轮内作答。适合快速征求第二意见。
• heropedia-office-hour — 由任意英雄主持的五阶段结构化多轮会话。在 “let hold office hours”、“office hour with ”、“office hour on ” 等短语出现时触发。英雄开场后，会一次提出一个问题，连续提出 5–6 个具有启发性的问题（如果角色设有精选的 ## Office Hour Questions 部分，则从中选取；否则即时提炼），针对你的实际问题直接表明立场，然后给出诊断、一周行动方案和风险警示。笔记会保存到本地的 ~/.heropedia/office-hours/。适合希望受到推动，而不只是得到回答的情况。

两个 skill 都拒绝杜撰角色——它们总会先从 heropedia 获取规范提示词，再开始作答。

一个 office-hour skill，四种 Agent

skills/heropedia-office-hour/SKILL.md 是一个采用开源 Agent Skills 格式的单一文件。该文件可在以下环境中运行：

Agent	安装方式	笔记保存条件
Claude Code	claude plugin install heropedia@heropedia（见下文）	始终保存
Codex CLI	install-codex.sh --with-skills（见下文）	启动 Codex 时使用 --add-dir ~/.heropedia，或在询问时批准写入。否则，笔记会打印在聊天中。
Gemini CLI	gemini extensions install https://github.com/SiliconRoshiBill/heropedia-plugin	启动 Gemini 时使用 --include-directories ~/.heropedia。否则，笔记会打印在聊天中。
Antigravity	见 Google — Antigravity	尚未完成端到端验证。如果写入受阻，笔记会打印在聊天中。

重新运行安装命令即可将 skill 升级到最新版本。

安装

选择你的 AI。所有安装方式都指向同一端点（https://www.heropedia.org/mcp）。

Anthropic — Claude Code（推荐）

claude plugin marketplace add https://github.com/SiliconRoshiBill/heropedia-plugin
claude plugin install heropedia@heropedia

自动将 MCP 服务注册为 plugin:heropedia:heropedia。打开新会话即可使用。

Anthropic — Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "heropedia": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.heropedia.org/mcp"]
    }
  }
}

OpenAI — ChatGPT（网页 / macOS / Windows 应用）

Plus、Pro、Business、Enterprise 和 Edu 方案可用（Free / Team 不可用）。

1. 设置 → Connectors → Advanced → 开启 Developer mode。
2. 设置 → Connectors → Add custom connector。
3. 粘贴 MCP URL：https://www.heropedia.org/mcp
4. 身份验证：No authentication。保存。
5. 在需要使用的聊天中启用 Heropedia 连接器。

Business / Enterprise 工作区：由工作区管理员通过 Workspace Settings → Connectors → New app 添加连接器。

OpenAI — Codex（CLI）

curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash

添加 --with-agents，同时安装用于强制执行工作流的 AGENTS.md；添加 --with-skills，将 office-hour 技能安装（或升级）到 ~/.codex/skills/：

curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/codex/install-codex.sh | bash -s -- --with-agents --with-skills

若要让 office hour 将笔记保存到 ~/.heropedia/office-hours/，请使用 codex --add-dir ~/.heropedia 启动 Codex。

也可以手动添加到 ~/.codex/config.toml：

[mcp_servers.heropedia]
url = "https://www.heropedia.org/mcp"

OpenAI — Agents SDK

Python（openai-agents-python）：

from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={"url": "https://www.heropedia.org/mcp"},
    name="heropedia",
) as server:
    agent = Agent(
        name="ConsultantAgent",
        instructions=(
            "When the user asks to consult a specific expert, call "
            "getListByHero to find the entry, then getDetail to fetch "
            "the canonical prompt. Apply that persona — do not paraphrase."
        ),
        mcp_servers=[server],
    )
    result = await Runner.run(agent, "Ask Warren Buffett to review my pricing page.")
    print(result.final_output)

TypeScript（@openai/agents）：

import { Agent, Runner } from "@openai/agents";
import { MCPServerStreamableHttp } from "@openai/agents/mcp";

const heropedia = new MCPServerStreamableHttp({
  url: "https://www.heropedia.org/mcp",
  name: "heropedia",
});

const agent = new Agent({
  name: "ConsultantAgent",
  instructions:
    "When the user asks to consult a specific expert, call getListByHero " +
    "to find the entry, then getDetail to fetch the canonical prompt. " +
    "Apply that persona — do not paraphrase.",
  mcpServers: [heropedia],
});

const result = await Runner.run(agent, "Ask Warren Buffett to review my pricing page.");
console.log(result.finalOutput);

Google — Gemini CLI

此仓库是 Gemini CLI 扩展：gemini-extension.json 会注册 MCP 服务，skills/ 下的两个技能也会自动载入。

gemini extensions install https://github.com/SiliconRoshiBill/heropedia-plugin   # upgrade later: gemini extensions update heropedia
gemini --include-directories ~/.heropedia                                          # lets the office hour save notes

仅使用 MCP — 将以下内容粘贴到 Gemini 配置中：

{
  "mcpServers": {
    "heropedia": {
      "httpUrl": "https://www.heropedia.org/mcp"
    }
  }
}

Google — Antigravity

在 ~/.gemini/antigravity/mcp_config.json 中注册 MCP 服务：

{
  "mcpServers": {
    "heropedia": {
      "serverUrl": "https://www.heropedia.org/mcp"
    }
  }
}

将 office-hour 技能安装到 ~/.gemini/config/skills/。这是全局技能文件夹，所有 Antigravity 版本（IDE、CLI、Agent）都会读取：

mkdir -p ~/.gemini/config/skills/heropedia-office-hour
curl -sSL https://raw.githubusercontent.com/SiliconRoshiBill/heropedia-plugin/main/skills/heropedia-office-hour/SKILL.md \
  -o ~/.gemini/config/skills/heropedia-office-hour/SKILL.md

重新运行 curl 命令即可升级。

Cursor

添加到 Cursor MCP 配置文件：

{
  "mcpServers": {
    "heropedia": {
      "url": "https://www.heropedia.org/mcp"
    }
  }
}

任意 HTTP MCP 客户端

直接向 https://www.heropedia.org/mcp 发送 JSON-RPC 2.0 POST 请求。示例请参阅 heropedia.org/mcp-guide。

试试看

安装后，只需提出以下请求：

“请 Warren Buffett 评审我的 SaaS 定价页面。” “请 Steve Jobs 严厉点评这个着陆页。” “就这个是否继续推进的决定，咨询 Charlie Munger。” “Linus Torvalds 会如何评价这次重构？” “请一位产品评论家看看这份功能规格说明。”

Claude 将会：

1. 识别角色意图。
2. 调用 mcp__heropedia__getListByHero 查找条目。
3. 调用 mcp__heropedia__getDetail 获取规范提示词。
4. 通过该角色的视角作答。

如果一个姓名对应多个角色（例如，Warren Buffett 可以是投资者，也可以是业务分析师），Claude 会先询问哪种视角适合你的任务，然后再作答。

包含内容

heropedia-plugin/
├── .claude-plugin/
│   ├── plugin.json          # plugin manifest
│   └── marketplace.json     # marketplace listing (installable via `claude plugin marketplace add`)
├── .mcp.json                # MCP server registration
├── skills/
│   ├── heropedia/
│   │   └── SKILL.md         # single-turn "ask an expert" skill
│   └── heropedia-office-hour/
│       └── SKILL.md         # five-phase multi-turn office-hour skill
├── scripts/
│   ├── validate-skill.sh    # structural lint for office-hour SKILL.md
│   └── test-scenarios.md    # manual QA scenarios
├── codex/                   # Codex CLI installer (MCP, AGENTS.md, skills)
├── gemini-extension.json    # Gemini CLI extension descriptor (MCP + skills/)
└── README.md

要求

• Claude Code（任意近期版本）。
• 互联网连接 — MCP 服务托管于 https://www.heropedia.org/mcp。
• 无其他要求。无需 API 密钥或账户。公共端点，按 IP 限流（列表请求为 300 req/min，详情请求为 60 req/min）。

MCP 端点

位于 https://www.heropedia.org/mcp 的公共 HTTP MCP 服务，使用 MCP 2025-06-18 Streamable HTTP。提供四种只读工具：

工具	用途
getList	分页列出所有人物 × 角色条目
getListByHero	按人物姓名筛选（正则表达式，不区分大小写，使用安全语法）
getListByRole	按角色名称筛选（遵循相同的正则表达式规则）
getDetail	返回单个条目的完整规范 Markdown

LIST 工具返回轻量级元数据（{id, hero_name, role_name, description}）；只有 getDetail 会返回完整的角色提示词。

用户指南包含安装片段、示例和常见问题：heropedia.org/mcp-guide

卸载

claude plugin uninstall heropedia

许可证

MIT。请参阅 LICENSE。

heropedia.org 上的角色内容采用单独的 MIT 许可证，位于内容仓库 SiliconRoshiBill/heropedia。

贡献新人物

任何拥有 GitHub 账户的人都可以提交。请在 heropedia.org/submit 提交。社区将投票选出最佳版本。