Codex Skill noahnan-max · Stars: 8 · 1 commit

Private Equity
Investment DD Skill

将杂乱的 BP、访谈记录、合同、财务报表转化为可上投委会的 standalone HTML 尽调报告。一套基于五本中文尽调书方法论的 Codex Skill 执行框架。

GitHub →

一、结果 — 这个 Skill 能产出什么

你给这个 Skill 一批材料,它最终给你一个 可以直接拿去投委会讨论的 standalone HTML 报告,里面包含:

  1. 投资结论和执行摘要 — 投还是不投,要说清楚
  2. 资料边界清单 — 你给了什么、没给什么、什么只是草稿、什么来自管理层口述
  3. 公司基础信息完整表 — 主体名称、历史沿革、股权结构、治理、激励、交易条款、产品线、团队、财务基础
  4. 投资逻辑和关键假设 — 这个案子为什么成立,必须为真的前提是什么
  5. 行业与市场分析 — 公司在赛道里的位置
  6. 产品、技术和商业模式分析
  7. 客户、收入、订单、渠道、供应链分析
  8. 财务尽调 / QoE — 收入质量、现金流、预测合理性
  9. 法律、税务、合规风险
  10. 估值、回报和退出方案
  11. 红旗登记表 — 按 P0/P1/P2 分级,每个红旗必须带有交易动作
  12. 资料缺口清单和下一步查验清单
  13. 交割条件和投后 100 天计划

除了完整 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 QAPython 解析 HTML、扫描敏感内容、检查桌面和移动端阅读体验交付前过闸门

适配器机制

Skill 根据 交易类型行业 选择适配器:

证据体系

每项判断必须标注证据等级:

等级来源可信度
1官方原始文件(审计报告、银行流水、税务申报、合同、发票、许可证)★★★★★
2第三方确认(客户/供应商访谈、银行确认、专家意见)★★★★
3内部系统导出(ERP、CRM、订单台账)★★★
4管理报表和明细表★★
5管理层访谈、BP/CIM 口径★ 只能形成假设
6媒体、市场材料、传闻☆ 参考级

三、特点 — 和一般“让 AI 写报告”有什么不同

1. 强制四步先于结论

普通做法是“你说要投这家,我帮你充分论证”。这个 Skill 相反——在没有完成资料盘点、基础信息抽取、证据矩阵、红旗扫描之前,不让你出结论

2. 五书方法论融合

Skill 不是凭空发明规则,而是综合了五本中文尽调书的方法论:

如果只用一个 checklist,会漏掉其他书的维度。Skill 在每个模块检查是否五个视角都覆盖了。

3. 以“交易动作”为终点

不搞“这个风险很高”的废话。每个问题必须落到具体行动:停止交易 / 暂停等证据 / 重定价 / 加入交割条件 / 要求陈述保证 / 赔偿 / 托管 / 治理权 / 第三方复核 / 投后 100 天计划

4. 只识别风险,不替代专业人士

遇到法律、税务、知识产权、劳动、环保、安全、诉讼问题,Skill 只会说“这里有风险,请找律师/会计师/专利代理人复核”,不会假装给出专业意见。

5. 质量闸门在交付前

四、安装 — 怎么用

前置条件

这个 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 研究主题的关联点:

  1. Skill 封装哲学 — 如何将领域知识编码为可执行指令集
  2. reference 体系 — 多文件拆解复杂方法论,入口文件负责编排
  3. 质量门控 — 在 AI 生成流程中嵌入自检
  4. 与 CLI 集成方式 — 直接 clone 到本地 skills 目录即可使用,零配置

关键问题

Q1: 数据从哪里来?Skill 是否提供了数据来源网站或 API?

所有数据由用户提供,Skill 本身不包含任何数据源。

Skill 的功能是「处理用户给的材料」,而不是「自己去搜集数据」。预期的用户输入包括:BP/CIM、审计报告、管理报表、合同、发票、验收单、数据室文件、飞书/云文档、访谈记录、会议纪要、公开信息、第三方报告。

Skill 中没有硬编码任何数据来源网址、API endpoint 或 key。references/ 下的所有文件都是方法论指导,不是数据源配置。对于数据缺口,Skill 的做法是标出「缺了什么」并生成「资料需求清单」,让用户自己去补充。

Q2: 外部访问通过什么方式?是否规定了浏览器或其他访问手段?

Skill 没有规定任何外部访问的技术手段。

SKILL.md 和 references/ 文件中完全没有提及浏览器、HTTP 请求、web scraping、API 调用等具体的工具或访问方式。这是因为:

Q3: 从 Codex CLI 迁移到 opencode — 逐项对比与完整部署

原始文件审查

SKILL.md 已使用 --- YAML frontmatter,包含 name: private-equity-investment-dddescription 字段。

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 vs opencode — 逐维度对比

对比维度Codex CLIopencode评估
Skill 文件SKILL.mdSKILL.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 无需任何修改。

部署步骤

Step 1:复制文件
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/
Step 2:增强 frontmatter(建议)
---
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
---
Step 3:创建 opencode 自定义 Agent(必须

创建 ~/.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.yamlopencode pe-dd.md
interface.display_name文件名 pe-dd
interface.short_descriptiondescription frontmatter
interface.default_promptMarkdown 正文
Step 4:配置权限(必须
{
  "permission": {
    "skill": {
      "*": "ask",
      "private-equity-investment-dd": "allow"
    }
  }
}
Step 5:验证
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 兼容性

背景

OpenClaw 和 Hermes Agent 是 2026 年 GitHub 上最受关注的两个开源 AI Agent 框架:

OpenClawHermes Agent
维护方Peter SteinbergerNous Research
Stars180,000+102,000+
定位个人 AI 助理,多渠道消息处理开源自进化 AI Agent
官网openclaw.aihermes-agent.nousresearch.com

核心发现:SKILL.md 是四家平台的交叉兼容格式

平台Skill 文件Frontmatter存放路径
Codex CLISKILL.md--- YAML (name + description)~/.codex/skills/<name>/
opencodeSKILL.md--- YAML (name + description + 可选)~/.config/opencode/skills/
OpenClawSKILL.md--- YAML (name + description + 可选)~/.openclaw/skills/
HermesSKILL.md--- YAML (version/author/category + 可选)~/.hermes/skills/

四家全部支持 references/ 子目录。PE-DD Skill 的 SKILL.md 可零修改部署。

OpenClaw 部署

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: truemetadata.openclaw.emoji/tags

Hermes 部署

hermes skills install noahnan-max/private-equity-investment-dd-skill

安装后自动注册为 /private-equity-investment-dd 斜杠命令。不需要单独创建 Agent 配置文件。

四平台对比

CodexopencodeOpenClawHermes
修改量无(原生)+3 字段+5 字段
Agent 配置已有必须新建建议新建不需要
触发方式$skill-nameskill() tool自动匹配/skill 斜杠
亮点原生权限最细多渠道自进化

📁 目录结构

AIToolStack/
├── index.html
├── AIToolStack_GitHub_PE-DD-Skill.html
├── AIToolStack_GitHub_PE-DD-Skill.md
└── ...

📅 最后更新: 2025-05-22 | PE-DD Skill 版本: v1.0.0