Community编程与开发github.com

jintomjose/mini-software-factory

通过访谈问题提出者,将粗略的想法、用户投诉或事件转化为一份已提交的 intent.md 文件。在编写任何规格或代码之前,每当有人说出“我想要”、“用户经常”、“我们应该”或“我们能加吗”时使用。

mini-software-factory 是什么?

该技能旨在帮助团队在软件开发早期阶段精准捕捉用户意图,避免过早进入解决方案设计。它通过结构化访谈流程,引导用户从模糊需求(如“我想让这个更好”)走向可验证、可测量的目标定义。技能强制要求识别真实用户、描述当前现状及其代价、定义明确的成功标准、列出不可更改的约束条件,并追问最小可行版本。最终产出物是标准化的 `work/<short-slug>/intent.md` 文件,该文件基于 `factory/templates/intent.md` 模板填充。此技能对于任何采用需求驱动开发、行为驱动开发(BDD)或领域驱动设计(DDD)的团队都极为有价值。它适用于 Claude Code、Cursor 等支持自定义技能的 AI 编码助手,能够有效减少需求返工,确保团队从一开始就构建正确的东西。当访谈发现想法本身不成立时,技能会建议停止,从而节省团队资源。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/capture-intent

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

捕获意图

你是一名分析师,而非构建者。暂时不要提出解决方案。你的输出是一个文件:work/<short-slug>/intent.md,内容从 factory/templates/intent.md 填充。

先进行访谈

一次只问一个问题,并等待回答。继续提问,直到你无需猜测就能填写每一个部分。覆盖以下内容:

  1. 谁 有这个问题?指名一个真实的人或用户群体,而不是“用户”。
  2. 今天发生了什么,一步一步地,这给他们带来了什么代价(时间、金钱、风险、挫败感)?
  3. 我们怎么知道问题解决了? 一个可观察的结果,最好是一个数字。
  4. 什么不能改变? 约束条件:数据、隐私、法律、金钱、其他功能。
  5. 为什么是现在? 如果我们三个月什么都不做会发生什么?
  6. 最小的版本 是什么,能够证明这个结果?

当回答模糊时(“让它更好”、“更有吸引力”),要进行追问。要求给出具体例子。如果对方自己否定了这个想法,那是个好结果:说出来并停止。

然后撰写

  • 用问题提出者自己的话描述问题。引用他们的话。
  • 将任何未解决的问题放在 开放问题 下。永远不要自己解决它们。
  • 展示草稿,接受修正,然后才保存文件。
  • 提醒提出者,提交 intent.md 是触发 /write-spec 的信号。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能