agentleFS
Practice019Practice019/agent-skills/define/SKILL.md

define

Skill0 starsChanged 2 months agoMITView on GitHub

Define 阶段:写代码之前先想清楚『要做什么』。六条路径 —— 需求还没影(interview-me 反问出真实意图)、有模糊想法(idea-refine 结构化发散收敛)、要落成规格(spec-driven-development 先规格后代码)、要把质量标准写下来(constraint-driven-development 把评审口味变成可执行红线)、方案已成形但没人挑战过(grilling 设计树拷问)、要做视觉产物(design-blueprint 先出 DESIGN.md)。产出 SPEC.md / DESIGN.md / 约束配置,不含任何实现。Define phase: clarify WHAT to build before any code. Routes — interview-me (surface the real intent), idea-refine (divergent then convergent refinement), spec-driven-development (spec before code), constraint-driven-development (turn review taste into executable gates), grilling (design-tree stress test of an already-formed plan), design-blueprint (produce DESIGN.md for visual artifacts). Use when requirements are vague, when starting a new project or feature, when a plan needs stress-testing, or when a visual artifact needs a spec before pixels. Produces a spec, not an implementation. Four routes based on addyosmani/agent-skills v0.6.9.

11 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Define(定义阶段 · 路由)

来源:addyosmani/agent-skills v0.6.9 的 interview-me / idea-refine / spec-driven-development / constraint-driven-development。 本文件是路由层,四份原文都是本技能目录下的子文件,用 read 按相对路径读取。

另有两条本地路由:grilling.md(本目录)与 ../design-blueprint/SKILL.md(顶层技能)。 上游没有对应的「方案完备性拷问」与「视觉产物规格」入口,这两条是本地补齐的, 不随上游升级变动——将来上游升级时只覆盖上面那四份。

这个阶段干什么

写代码之前,先想清楚「要做什么」。 产出是规格,不是实现。

⚠️ 本技能内嵌的子文件没有注册成独立技能,skill 工具加载不到。 一律用 read <文件名> 读取(相对本技能目录)。

路由表

你现在的情况读一句话
还不知道自己要什么interview-me.md通过反问把真实意图问出来
有模糊想法,想看几种可能idea-refine.md结构化发散 + 收敛,把想法磨清楚
要把它写成规格spec-driven-development.md先规格后代码
要把质量标准写下来constraint-driven-development.md把「评审口味」变成可执行门禁
方案已成形,但没人挑战过grilling.md设计树拷问:每问带推荐答案,逼出静默假设
要做的是视觉产物(页面/海报/PPT/图表)../design-blueprint/SKILL.md先出 DESIGN.md(结构布局 + Decision Trace),再谈实现

★ 拿不准从哪开始 → 先 interview-me.md。 最常见的失败是「需求模糊却直接开写」—— 假设做错了,后面全是返工。

典型顺序

interview-me              → 问出真实意图(还没想清时)
    ↓
idea-refine               → 把想法磨成几个可选方向(想法还模糊时)
    ↓
spec-driven-development   → 写成规格 + 验收标准
    ↓
constraint-driven-development → 把质量红线固化成可执行检查(可选,团队级)

拷问(grilling)插在方案成形之后、写规格之前:先用 idea-refine.md / 自己的思考把方案定下来, 再用 grilling.md 走一遍设计树,确认分支都走过、没有静默假设,最后才交给 spec-driven-development.md 落笔。 顺序反过来会变成「拷问一个还不存在的方案」。

视觉产物先出规格:页面 / 海报 / PPT / 图表类任务,在写规格的同时读 ../design-blueprint/SKILL.md, 先产出 DESIGN.md(结构布局 + Decision Trace);没有 DESIGN.md 就进实现,大概率产出「AI 味」的模板脸。

不是每一步都要走。 需求已经很清楚 → 直接 spec-driven-development.md。

规格该包含什么

用 spec-driven-development.md 的模板。最低限度要有:

  • 要构建什么 —— 一段话
  • 验收标准 —— 二元、可测(「能登录」不算,要能判真假)
  • 不做什么 —— 范围边界,防止蔓延
  • 已知约束 —— 技术栈 / 兼容性 / 性能要求

典型规格落点

SPEC.md            仓库根
docs/SPEC.md       或这里
spec/*             或这里

⚠️ 只认这三个位置。 README 或随便一份文档不算规格 —— 下游(plan / build)会按这三个路径去找,找不到就停。

边界

做:澄清需求、探索方案、写规格、固化质量红线。

不做:

  • ❌ 不写实现代码 —— 那是 build
  • ❌ 不拆任务 —— 那是 plan
  • ❌ 不发明需求 —— 规格里没有的东西,问,别猜

★ 共享纪律(亮出假设 / 管理困惑 / 该反对就反对 / 强制简单 / 守住范围 / 验证不假设) 见 meta 技能。其中「亮出假设」在本阶段最吃重 —— 假设错了,后面每个阶段都在放大它。

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.

Reviews can't be read right now.

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.