将杂乱的 BP、访谈记录、合同、财务报表转化为可上投委会的 standalone HTML 尽调报告。一套基于五本中文尽调书方法论的 Codex Skill 执行框架。
你给这个 Skill 一批材料,它最终给你一个 可以直接拿去投委会讨论的 standalone HTML 报告,里面包含:
除了完整 HTML 报告,也可单独要求:IC Memo、红旗扫描、管理层访谈提纲、资料需求清单、QoE 初稿等局部产出。
| 步骤 | 做什么 | 为什么 |
|---|---|---|
| 1. Intake | 确认项目名称、交易类型、决策阶段、投资角色、输出格式 | 先搞清楚场景再用对应方法 |
| 2. Material Inventory | 盘点 BP/CIM、财务表、合同、数据室、访谈、公开信息 | 区分原始文件、草稿、口述、第三方报告 |
| 3. Basic Information Pack | 抽公司主体信息、历史沿革、股权治理、交易事实、产品、团队、财务基础 | 不跳步,基础信息不能因为结论清楚就省略 |
| 4. Investment Thesis | 写清楚“这个交易凭什么成立”和“必须为真的关键假设” | 先有逻辑再找证据,不是先看材料再凑结论 |
| 5. Adapter Selection | 选择交易类型适配器 + 行业适配器 | 不同类型项目关注点不同 |
| 6. Book Fusion Coverage | 检查每个模块是否融合了五本书的视角 | 避免只用一种 checklist 风格 |
| 7. Hypothesis Tree | 把投资逻辑拆成业务/行业/财务/法律/团队/估值/退出等可验证问题 | 从模糊命题变成可回答的具体问题 |
| 8. Evidence Matrix | 每个判断 → 证据 → 来源 → 状态 → 缺口 → 交易影响 | 管理层口述只能是假设,不能直接当结论 |
| 9. Triangulation | 业务口述、财务数据、行业证据相互校验 | 防讲故事 |
| 10. Valuation / Return / Exit / Terms | 估值方法、回报情景、退出路径、条款保护 | 估值不是拍数,要跟证据和风险关联 |
| 11. Red-Flag Gate | 按 P0/P1/P2 标记风险,每个必须写明交易动作 | 不是列一堆风险就完了 |
| 12. HTML Report Draft | 生成结论先行、证据可追踪、表格充分的 standalone HTML | 投委会要直接看的东西 |
| 13. Final QA | Python 解析 HTML、扫描敏感内容、检查桌面和移动端阅读体验 | 交付前过闸门 |
Skill 根据 交易类型 和 行业 选择适配器:
每项判断必须标注证据等级:
| 等级 | 来源 | 可信度 |
|---|---|---|
| 1 | 官方原始文件(审计报告、银行流水、税务申报、合同、发票、许可证) | ★★★★★ |
| 2 | 第三方确认(客户/供应商访谈、银行确认、专家意见) | ★★★★ |
| 3 | 内部系统导出(ERP、CRM、订单台账) | ★★★ |
| 4 | 管理报表和明细表 | ★★ |
| 5 | 管理层访谈、BP/CIM 口径 | ★ 只能形成假设 |
| 6 | 媒体、市场材料、传闻 | ☆ 参考级 |
普通做法是“你说要投这家,我帮你充分论证”。这个 Skill 相反——在没有完成资料盘点、基础信息抽取、证据矩阵、红旗扫描之前,不让你出结论。
Skill 不是凭空发明规则,而是综合了五本中文尽调书的方法论:
如果只用一个 checklist,会漏掉其他书的维度。Skill 在每个模块检查是否五个视角都覆盖了。
不搞“这个风险很高”的废话。每个问题必须落到具体行动:停止交易 / 暂停等证据 / 重定价 / 加入交割条件 / 要求陈述保证 / 赔偿 / 托管 / 治理权 / 第三方复核 / 投后 100 天计划。
遇到法律、税务、知识产权、劳动、环保、安全、诉讼问题,Skill 只会说“这里有风险,请找律师/会计师/专利代理人复核”,不会假装给出专业意见。
这个 Skill 是 Codex CLI 的 Skill 包,需要有 Codex 环境。
# 方式一:直接 clone 到 skills 目录
mkdir -p ~/.codex/skills
git clone https://github.com/noahnan-max/private-equity-investment-dd-skill.git \
~/.codex/skills/private-equity-investment-dd
# 方式二:先 clone 到别处,再复制
git clone https://github.com/noahnan-max/private-equity-investment-dd-skill.git
rsync -a private-equity-investment-dd-skill/ \
~/.codex/skills/private-equity-investment-dd/
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py \
~/.codex/skills/private-equity-investment-dd
# 生成完整尽调报告
"请使用 private-equity-investment-dd skill,基于我提供的 BP、访谈记录、
会议纪要、财务表和合同,生成一份完整的 HTML 投资尽调报告。"
# 单独做红旗扫描
"这家公司收入增长很快,但应收账款也快速增长。
请基于资料做 PE 项目红旗扫描,输出风险等级、证据、交易影响和下一步查验清单。"
# 做 Pre-IPO 项目 IC Memo
"这是一个半导体 Pre-IPO 项目,请基于 BP、审计报告、客户订单和管理层访谈
生成 IC Memo,重点检查收入质量、客户集中度、产能、IP 和上市退出可行性。"
private-equity-investment-dd-skill/
├── README.md # 中英双语说明
├── SKILL.md # 核心定义,Codex 读取的入口
├── agents/
│ └── openai.yaml # Agent 配置
├── references/ # 14 个参考文档
│ ├── workflow.md # 工作流
│ ├── basic-information-extraction.md # 基础信息抽取
│ ├── book-fusion-coverage.md # 五书融合覆盖
│ ├── report-structure.md # 报告结构
│ ├── html-report-output.md # HTML 输出规范
│ ├── module-checklists.md # 逐模块检查清单
│ ├── evidence-and-red-flags.md # 证据与红旗规则
│ ├── red-flag-playbook.md # 红旗手册
│ ├── special-dd-adapters.md # 交易类型适配器
│ ├── industry-dd-adapters.md # 行业适配器
│ ├── valuation-and-terms.md # 估值与条款
│ ├── interview-and-data-room.md # 访谈与数据室
│ ├── report-writing-examples.md # 报告写作示例
│ ├── source-books.md # 方法论来源
│ └── self-test.md # 自测
└── .gitignore / LICENSE
本项目是 Codex Skill 生态的典型范例,与 AIToolStack 研究主题的关联点:
所有数据由用户提供,Skill 本身不包含任何数据源。
Skill 的功能是「处理用户给的材料」,而不是「自己去搜集数据」。预期的用户输入包括:BP/CIM、审计报告、管理报表、合同、发票、验收单、数据室文件、飞书/云文档、访谈记录、会议纪要、公开信息、第三方报告。
Skill 中没有硬编码任何数据来源网址、API endpoint 或 key。references/ 下的所有文件都是方法论指导,不是数据源配置。对于数据缺口,Skill 的做法是标出「缺了什么」并生成「资料需求清单」,让用户自己去补充。
Skill 没有规定任何外部访问的技术手段。
SKILL.md 和 references/ 文件中完全没有提及浏览器、HTTP 请求、web scraping、API 调用等具体的工具或访问方式。这是因为:
SKILL.md 已使用 --- YAML frontmatter,包含 name: private-equity-investment-dd 和 description 字段。
agents/openai.yaml 定义了一个 Agent interface:
interface:
display_name: "PE Investment DD"
short_description: "HTML-ready PE/VC investment DD reports"
default_prompt: "Use $private-equity-investment-dd to turn project materials
into a professional HTML investment due diligence report..."
| 对比维度 | Codex CLI | opencode | 评估 |
|---|---|---|---|
| Skill 文件 | SKILL.md | SKILL.md | 相同 |
| Frontmatter | --- YAML, name + description | --- YAML, name + description + 可选字段 | 已兼容 |
| name 命名 | 无明确约束 | ^[a-z0-9]+(-[a-z0-9]+)*$, 1–64字符 | 通过校验 |
| 安装路径 | ~/.codex/skills/<name>/ | .opencode/skills/ 或 ~/.config/opencode/skills/ | 需复制 |
| references/ | 14 个 .md 文件 | 同目录下 read tool 可读取 | 兼容 |
| Agent 配置 | agents/openai.yaml | .opencode/agents/ .md + frontmatter | 格式不同 |
| 加载机制 | 启动时全量加载 | skill tool 按需加载 | 等价 |
| 权限控制 | 无 | allow/deny/ask + 通配符 | opencode 更强 |
核心结论:SKILL.md 无需任何修改。
git clone https://github.com/noahnan-max/private-equity-investment-dd-skill.git \
/tmp/private-equity-investment-dd-skill
mkdir -p ~/.config/opencode/skills/private-equity-investment-dd
cp /tmp/private-equity-investment-dd-skill/SKILL.md \
~/.config/opencode/skills/private-equity-investment-dd/
cp -r /tmp/private-equity-investment-dd-skill/references \
~/.config/opencode/skills/private-equity-investment-dd/
---
name: private-equity-investment-dd
description: Use when Noah asks for private equity...
license: MIT
compatibility: opencode
metadata:
source: https://github.com/noahnan-max/private-equity-investment-dd-skill
category: investment-due-diligence
---
创建 ~/.config/opencode/agents/pe-dd.md:
---
description: HTML-ready PE/VC investment DD reports
mode: subagent
permission:
skill:
private-equity-investment-dd: allow
edit: allow
bash: allow
read: allow
---
You are a private equity investment due diligence specialist.
When the user asks for any DD task, start by loading the skill:
skill({ name: "private-equity-investment-dd" })
Then follow its Operating Contract strictly...
| Codex agents/openai.yaml | opencode pe-dd.md |
|---|---|
interface.display_name | 文件名 pe-dd |
interface.short_description | description frontmatter |
interface.default_prompt | Markdown 正文 |
{
"permission": {
"skill": {
"*": "ask",
"private-equity-investment-dd": "allow"
}
}
}
ls -la ~/.config/opencode/skills/private-equity-investment-dd/
ls ~/.config/opencode/agents/pe-dd.md
# 进入 opencode,输入 @pe-dd 确认 Agent 出现
~/.config/opencode/
├── agents/
│ └── pe-dd.md
└── skills/
└── private-equity-investment-dd/
├── SKILL.md
└── references/ (14 个 .md)
项目根目录/
└── opencode.json
OpenClaw 和 Hermes Agent 是 2026 年 GitHub 上最受关注的两个开源 AI Agent 框架:
| OpenClaw | Hermes Agent | |
|---|---|---|
| 维护方 | Peter Steinberger | Nous Research |
| Stars | 180,000+ | 102,000+ |
| 定位 | 个人 AI 助理,多渠道消息处理 | 开源自进化 AI Agent |
| 官网 | openclaw.ai | hermes-agent.nousresearch.com |
| 平台 | Skill 文件 | Frontmatter | 存放路径 |
|---|---|---|---|
| Codex CLI | SKILL.md | --- YAML (name + description) | ~/.codex/skills/<name>/ |
| opencode | SKILL.md | --- YAML (name + description + 可选) | ~/.config/opencode/skills/ |
| OpenClaw | SKILL.md | --- YAML (name + description + 可选) | ~/.openclaw/skills/ |
| Hermes | SKILL.md | --- YAML (version/author/category + 可选) | ~/.hermes/skills/ |
四家全部支持 references/ 子目录。PE-DD Skill 的 SKILL.md 可零修改部署。
git clone https://github.com/noahnan-max/private-equity-investment-dd-skill.git /tmp/pe-dd-skill
mkdir -p ~/.openclaw/skills/private-equity-investment-dd
cp /tmp/pe-dd-skill/SKILL.md ~/.openclaw/skills/private-equity-investment-dd/
cp -r /tmp/pe-dd-skill/references ~/.openclaw/skills/private-equity-investment-dd/
增加 OpenClaw 特有 frontmatter 字段:user-invocable: true、metadata.openclaw.emoji/tags。
hermes skills install noahnan-max/private-equity-investment-dd-skill
安装后自动注册为 /private-equity-investment-dd 斜杠命令。不需要单独创建 Agent 配置文件。
| Codex | opencode | OpenClaw | Hermes | |
|---|---|---|---|---|
| 修改量 | 无(原生) | 零 | +3 字段 | +5 字段 |
| Agent 配置 | 已有 | 必须新建 | 建议新建 | 不需要 |
| 触发方式 | $skill-name | skill() tool | 自动匹配 | /skill 斜杠 |
| 亮点 | 原生 | 权限最细 | 多渠道 | 自进化 |
📁 目录结构
AIToolStack/
├── index.html
├── AIToolStack_GitHub_PE-DD-Skill.html
├── AIToolStack_GitHub_PE-DD-Skill.md
└── ...