1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | idea-refine-addyosmani-agent-skills |
| 作者/维护者 | Addy Osmani（addyosmani/agent-skills 仓库维护者） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/idea-refine |
| 许可证 | MIT（GitHub API 核实） |
| GitHub Stars | 合集仓库整体 80,881；该数字属整个合集仓库，不代表本技能自身热度（GitHub API） |
| Forks | 8,722（仓库整体，GitHub API） |
| 最新版本 | 无独立版本号；子目录最近一次功能性提交为 2026-06-25（GitHub API commits 核实） |
| 安装方式 | npx skills add addyosmani/agent-skills，或手动复制 skills/idea-refine/ 目录 |
2. 功能介绍与亮点
idea-refine 是一个把模糊想法收敛成可执行方案的结构化对话技能。它引导三个阶段：
- 理解与发散：把想法改写成清晰的“How Might We”问题陈述，提出 3-5 个关键澄清问题，再用反转、去约束、换受众、组合、简化、放大规模、专家视角等七种思维透镜生成 5-8 个方向变体；若在代码仓库内运行还会读取现有架构作为约束。
- 评估与收敛：把有共鸣的方向聚类成 2-3 条清晰分支，逐条用用户价值、可行性、差异化三项压力测试，并显式列出每条方向背后未经验证的假设。
- 打磨与产出：生成一页纸 markdown 方案，包含问题陈述、推荐方向、关键假设、MVP 范围、“不做什么”清单和待解决问题，经用户确认后落盘。
技能自带三份参考文档（frameworks.md 补充发散思维框架、refinement-criteria.md 提供完整评估量表、examples.md 展示优质会话范例），SKILL.md 正文本身也写明了“反面模式”清单（如“不要机械生成 20+ 个想法”“不要当无脑附和机器”），可用性证据较扎实。
3. 适用场景
所属分类：元技能与 Agent 增强。适合项目早期、想法尚不成型时使用：独立开发者验证一个产品创意是否值得投入、产品经理在提交需求前先做方向性压力测试、工程师在动手写代码前先厘清“到底要解决什么问题”。产出的一页纸方案可直接作为后续任务拆解或规格撰写的输入。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库通过 Claude Code marketplace 分发，README 明确列出专属 setup 指南 |
| Codex | ✅ 原生支持 | README 列出 Codex 专属 setup 指南 |
| OpenClaw | ✅ 原生支持 | 通过通用安装 CLI（npx skills add）分发；该 CLI 官方 README 的 Supported Agents 表格明确列出 openclaw，安装路径 ~/.openclaw/skills/ |
| Hermes Agent | ✅ 原生支持 | 同一 CLI 的 Supported Agents 表格列出 hermes-agent，安装路径 ~/.hermes/skills/ |
5. 推荐理由
它把“头脑风暴”这个常被略过的环节变成一套可复现的结构化流程——先逼着你把想法说清楚、再强制发散再收敛、最后必须交付一份包含“不做什么”清单的一页纸方案，避免了直接跳进实现细节却没想清楚方向的常见问题。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 该子目录累计 8 次专属提交，其中 3 位外部贡献者的修复已被合并（路径规范化 bug、脚本可执行权限、frontmatter 规范化）；仓库整体 80,881 stars 属整个合集仓库，不代表本技能自身热度 |
| 可用性 | 9 | 单句对话即可触发，配套三份参考文档覆盖方法论与范例；所在仓库近期（2026-07-26）仍有提交，维护活跃；无付费依赖 |
| 安全性 | 9 | 详见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令与权限范围 | 仅一个可选初始化脚本 scripts/idea-refine.sh，功能为在本地创建 docs/ideas 目录，无其他权限索取 |
| ② 运行时联网外发 | 无，纯对话交互与本地文件读写 |
| ③ API key/凭据 | 不需要 |
| ④ 可疑指令 | 逐行检读 SKILL.md 正文与脚本内容，未发现隐蔽指令或提示注入迹象 |
| ⑤ 作者/组织信誉 | 个人开源作者，仓库完全开源可审计 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 子目录本身最近提交 2026-06-25，所在仓库持续活跃维护 |
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 idea-refine 的差异 |
|---|---|---|
| qiaomu-goal-meta-skill | 把模糊任务收敛成一条带验证/边界/暂停条件的单条 Codex 指令 | 直接产出可执行指令，没有发散阶段生成多个候选方向让用户比较取舍 |
| Spec Kit / spec-driven-development 一类技能 | 把已确定方向的需求转成正式规格文档，多阶段留痕、产出多份持久化文件 | 面向“方向已定、要写规格”的下游阶段，不覆盖“方向还没定”时的发散与比选 |
| planning-with-files | 多阶段文件化规划，强调人工分阶段确认 | 同样是下游规划工具，默认已有明确方向，不做想法层面的压力测试 |
idea-refine 定位在决策链条最前端——想法还模糊、方向未定时的发散比选环节，与上述“已有方向、要写文档/做规划”的工具形成清晰互补而非竞争。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
idea-refine 是 addyosmani/agent-skills 工程技能库的一个成员，该库设计了一套可组合使用的技能管线（例如先用访谈类技能明确用户诉求，再用 idea-refine 收敛想法方向，最后用规格驱动类技能产出正式文档），用户既可以按管线组合使用，也可以单独调用 idea-refine。
10. 安装使用方式
- 通用 CLI（推荐，覆盖全部四个目标 Agent）：
npx skills add addyosmani/agent-skills - 手动安装：克隆仓库后，将
skills/idea-refine/整个目录复制到对应 Agent 的 skills 目录（如 Claude Code 的~/.claude/skills/） - Claude Code Marketplace：仓库同时支持通过 Claude Code 官方 marketplace 流程安装
- 安装后注意事项：无需重启 Agent；直接用“帮我把这个想法理清楚”“对 [某概念] 做头脑风暴”“压力测试我的计划”等触发短语调用，或直接描述你的模糊想法即可自动触发
11. 注意事项
- 该子目录的外部贡献者数量有限（3 人），内容仍以维护者 Addy Osmani 主导，后续更新节奏依赖其个人精力
- 可选初始化脚本会在当前项目根目录创建
docs/ideas文件夹用于保存产出，多项目并行使用时注意该路径是否符合各项目自身的目录规范 - 最终一页纸方案需要用户在对话中手动确认才会落盘保存，避免了误覆盖，但也意味着不适合完全无人值守的自动化流程