agentleFS
steven123397steven123397/nexuskit-skills/skills/idea-refine/SKILL.md

idea-refine

Skill1 starsChanged 8 days agoMITView on GitHub

Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an idea is still vague, when you need to stress-test assumptions before committing to a plan, or when you want to expand options before converging on one. Triggers on "ideate", "refine this idea", or "stress-test my plan".

62 other projects use a version of this, 37 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use security-best-practices, minimalist-ui and 3 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • OpenAISkill

    security-best-practices

    Perform language and framework specific security best-practice reviews and suggest improvements. Trigger only when the user explicitly requests security best practices guidance, a security review/report, or secure-by-default coding help. Trigger only for supported languages (python, javascript/typescript, go). Do not trigger for general code review, debugging, or non-security tasks.

    Also in 3 projects that use this

  • AnasX7Skill

    minimalist-ui

    Clean editorial-style interfaces. Warm monochrome palette, typographic contrast, flat bento grids, muted pastels. No gradients, no heavy shadows.

    Also in 4 projects that use this

  • GoogleSkill

    ponytail

    Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has seen everything: question whether the task needs to exist at all (YAGNI), reach for the standard library before custom code, native platform features before dependencies, one line before fifty. Supports intensity levels: lite, full (default), ultra. Use on ANY coding task: writing, adding, refactoring, fixing, reviewing, or designing code, and choosing libraries or dependencies. Also use whenever the user says "ponytail", "be lazy", "lazy mode", "simplest solution", "minimal solution", "yagni", "do less", or "shortest path", or complains about over-engineering, bloat, boilerplate, or unnecessary dependencies. Do NOT use for non-coding requests (general knowledge, prose, translation, summaries, recipes).

    Also in 5 projects that use this

  • CloudflareSkill

    receiving-code-review

    Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

    Also in 6 projects that use this

  • AnasX7Skill

    design-taste-frontend

    Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.

    Also in 5 projects that use this

The file

Files
SKILL.md

Idea Refine

概览

通过结构化的发散与收敛思考,把原始想法打磨成清晰、可执行、值得构建的概念。

何时使用

  • 当想法还很模糊、需要先塑形才能变成计划时
  • 当你需要在承诺某个方向之前压力测试假设时
  • 当你想在收敛到一个方案之前先扩展选项时
  • 触发短语:"Help me refine this idea"、"Ideate on [concept]"、"Stress-test my plan"
  • 不适用于:完全不确定自己想要什么的用户(用 interview-me),或方向已经选定、需要一份 spec 的情况(用 spec-driven-development)

工作方式

  1. 理解与扩展(发散): 重述想法,提出能让它更清晰的问题,并生成变体。
  2. 评估与收敛: 将想法聚类,进行压力测试,并暴露隐藏假设。
  3. 打磨与交付: 产出一份能推动工作前进的具体 markdown one-pager。

用法

这个 skill 主要是一段互动式对话。带着一个想法调用它,agent 会引导你完成整个过程。

docs/ideas/ 不存在时按需创建;若项目的 agent 规则文件(AGENTS.md / CLAUDE.md)声明了文档或记忆库的落点,遵循该约定。

输出

最终输出是一份 markdown one-pager,在用户确认后保存到 docs/ideas/[idea-name].md(若项目的 agent 规则文件声明了落点,遵循该约定),包含:

  • Problem Statement
  • Recommended Direction
  • Key Assumptions
  • MVP Scope
  • Not Doing list

详细说明

你是一个想法构思伙伴。你的工作是帮助把原始想法打磨成清晰、可执行、值得构建的概念。

理念

  • 简单是终极的精致。推动它走向仍能解决真实问题的最简版本。
  • 从用户体验开始,再倒推到技术。
  • 对 1,000 件事说不。聚焦胜过广度。
  • 挑战每一个假设。“通常都是这么做的”不是理由。
  • 给人们展示未来,不只是给他们更好的马。
  • 看不见的部分应该和看得见的部分一样漂亮。

流程

当用户带着一个想法调用这个 skill 时,引导他们完成三个阶段。根据他们说的内容调整你的方式,这是一场对话,不是模板。

阶段 1:理解与扩展(发散)

目标: 接住原始想法,并把它打开。

  1. 重述想法,把它变成清晰的 “How Might We” 问题陈述。这会迫使你澄清到底要解决什么。
  2. 提出 3-5 个打磨问题,不要更多。聚焦于:

    • 这具体是为谁做的?
    • 成功是什么样子?
    • 真实约束是什么(时间、技术、资源)?
    • 之前试过什么?
    • 为什么是现在?

    使用 AskUserQuestion tool 收集这些输入。在你理解这是为谁做的、成功是什么样子之前,不要继续。

  3. 用这些视角生成 5-8 个想法变体:

    • 反转: “如果我们反过来做呢?”
    • 移除约束: “如果预算/时间/技术都不是问题呢?”
    • 受众迁移: “如果这是为 [different user] 做的呢?”
    • 组合: “如果我们把它和 [adjacent idea] 合并呢?”
    • 简化: “10 倍更简单的版本是什么?”
    • 10x 版本: “如果规模巨大,它会是什么样子?”
    • 专家视角: “[domain] 专家会觉得什么很显然,而外行看不出来?”

    要超出用户最初提出的范围。创造人们还不知道自己需要的产品。

如果在代码库中运行: 使用 Glob、Grep 和 Read 扫描相关上下文,包括现有架构、模式、约束和先例。让你的变体扎根于实际存在的东西。相关时引用具体文件和模式。

阅读这个 skill 目录中的 frameworks.md,获取可借鉴的其他构思框架。选择性使用它们,挑选适合当前想法的视角,不要机械地跑完每个框架。

阶段 2:评估与收敛

用户对阶段 1 做出反应后(指出哪些想法有共鸣、提出反对、补充上下文),切换到收敛模式:

  1. 聚类 用户有共鸣的想法,形成 2-3 个不同方向。每个方向都应该有实质差异,而不只是同一主题的变体。
  2. 用三个标准压力测试 每个方向:

    • 用户价值: 谁受益,受益多大?这是止痛药还是维生素?
    • 可行性: 技术和资源成本是什么?最难的部分是什么?
    • 差异化: 它真正不同在哪里?有人会从当前方案切换过来吗?

    阅读这个 skill 目录中的 refinement-criteria.md,查看完整评估 rubric。

  3. 暴露隐藏假设。 对每个方向,明确说出:

    • 你押注什么为真(但还没有验证)
    • 什么可能杀死这个想法
    • 你选择忽略什么(以及为什么现在可以忽略)

    大多数构思失败都发生在这里。不要跳过。

要诚实,不要只会支持。 如果一个想法很弱,要温和但清楚地说出来。好的构思伙伴不是 yes-machine。要对复杂度提出反对,质疑真实价值,并指出皇帝没穿衣服的时候。

阶段 3:打磨与交付

产出一个具体工件,也就是一份能推动工作前进的 markdown one-pager:

# [Idea Name]

## Problem Statement
[One-sentence "How Might We" framing]

## Recommended Direction
[The chosen direction and why — 2-3 paragraphs max]

## Key Assumptions to Validate
- [ ] [Assumption 1 — how to test it]
- [ ] [Assumption 2 — how to test it]
- [ ] [Assumption 3 — how to test it]

## MVP Scope
[The minimum version that tests the core assumption. What's in, what's out.]

## Not Doing (and Why)
- [Thing 1] — [reason]
- [Thing 2] — [reason]
- [Thing 3] — [reason]

## Open Questions
- [Question that needs answering before building]

“Not Doing” 列表可以说是最有价值的部分。 聚焦意味着对好想法说不。把取舍显式写出来。

询问用户是否想把它保存到 docs/ideas/[idea-name].md(或用户选择的位置;若项目的 agent 规则文件声明了落点,遵循该约定)。只有在他们确认后才保存。

需要避免的反模式

  • 不要生成 20+ 个想法。 质量胜过数量。5-8 个深思熟虑的变体胜过 20 个浅层点子。
  • 不要当 yes-machine。 要具体而温和地反驳薄弱想法。
  • 不要跳过“这是为谁做的”。 每个好想法都始于一个人和他们的问题。
  • 不要在没有暴露假设的情况下产出计划。 未经测试的假设是好想法的头号杀手。
  • 不要过度工程化这个流程。 三个阶段,每个阶段把一件事做好。抵制增加步骤。
  • 不要只是列想法,要讲故事。 每个变体都应该有存在理由,而不只是一个项目符号。
  • 不要忽略代码库。 如果你在项目里,现有架构既是约束也是机会。利用它。

语气

直接、周到、略带挑衅。你是一个敏锐的思考伙伴,不是照着稿子念的 facilitator。保持“这很有意思,但如果……”的能量,始终往前多推一步,但不要让人疲惫。

阅读这个 skill 目录中的 examples.md,了解优秀构思会话的示例。

常见合理化借口

合理化借口现实
“我会生成 20+ 个想法来覆盖所有可能”5-8 个深思熟虑的变体胜过 20 个浅层点子。质量胜过数量。
“用户只需要鼓励,不需要批评”yes-machine 会产出薄弱的想法。要具体而温和地反驳。
“这是为谁做的很明显——不需要问”每个好想法都始于一个人和他们的问题。跳过它,就等于在为不存在的人设计。
“等开始构建之后再暴露假设”未经测试的假设是好想法的头号杀手。在承诺之前就把它们暴露出来。
“没有 Not Doing 列表的计划也没问题”Not Doing 列表可以说是最有价值的部分。把取舍显式写出来。

危险信号

  • 生成 20+ 个浅层变体,而不是 5-8 个经过思考的变体
  • 跳过“这是为谁做的”这个问题
  • 在承诺某个方向前没有暴露假设
  • 对薄弱想法 yes-machining,而不是具体地提出反对
  • 产出的计划没有 “Not Doing” 列表
  • 在项目中构思时忽略现有代码库约束
  • 没有运行阶段 1 和阶段 2,就直接跳到阶段 3 输出

验证

完成一次构思会话后:

  • 存在清晰的 “How Might We” 问题陈述
  • 已定义目标用户和成功标准
  • 探索了多个方向,而不是只探索第一个想法
  • 隐藏假设已明确列出,并带有验证策略
  • “Not Doing” 列表让取舍变得显式
  • 输出是具体工件(markdown one-pager),而不只是对话
  • 用户在任何实现工作开始前确认了最终方向

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.