问题分析师 HTML Report Skill

作者：AiyaFun

一个用于把复杂问题整理成 HTML 行动报告的 Codex Skill。它会按照 5W1H、影响分析、解决方案探索、视角转换、执行检查清单和复盘提升指引，把模糊问题拆成可执行、可验证、可复盘的结构化报告。

适合场景

• 分析个人决策、学习路径、职业发展问题
• 分析团队流程、项目延期、协作冲突问题
• 把用户原始问题转成一份可直接打开的 HTML 报告
• 区分事实、假设、矛盾点和下一步验证动作
• 形成行动计划和风险预案

项目结构

.
├── problem-analysis-html-report/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   ├── examples/
│   │   ├── sample-analysis.json
│   │   └── sample-ai-learning-analysis.json
│   └── scripts/render-problem-report.mjs
├── outputs/
│   ├── sample-problem-analysis-report.html
│   └── sample-ai-learning-problem-analysis-report.html
├── LICENSE
├── README.md
└── package.json

快速使用

渲染“如何学习 AI”示例：

npm run render:ai-learning

渲染团队项目延期示例：

npm run render:team-delay

也可以直接调用脚本：

node problem-analysis-html-report/scripts/render-problem-report.mjs \
  problem-analysis-html-report/examples/sample-ai-learning-analysis.json \
  outputs/sample-ai-learning-problem-analysis-report.html

在 Codex 中使用

把 problem-analysis-html-report 目录放到 Codex 的 skills 目录后，可以这样调用：

用 problem-analysis-html-report 分析这个问题，并生成 HTML 报告

Skill 会先把问题整理成结构化 JSON，再使用 scripts/render-problem-report.mjs 渲染为自包含 HTML。

报告内容

生成的 HTML 默认包含：

• 原始问题内容
• 核心问题一句话
• 事实与假设
• 矛盾点二次验证
• 5W1H 问题定义
• 个人、团队、相关方影响
• 短期、中期、长期影响
• 逆向思考和跨界借鉴
• 资源盘点和限制条件
• 风险预判和预警信号
• 专家、新人、未来、系统视角
• 优先级矩阵
• 三阶段执行步骤
• Plan B 和 Plan C
• 复盘提升和预防机制

示例报告

在线示例可以直接点击：

• 示例首页
• 如何学习 AI
• 团队项目反复延期

仓库内也保留了 HTML 文件：

• outputs/sample-ai-learning-problem-analysis-report.html
• outputs/sample-problem-analysis-report.html

开源协议

MIT License

Copyright (c) 2026 AiyaFun