人类的意图,AI 的执行。

传递意图
而非代码。

定义 Why、What 和 Not。技术栈、架构、时间线、实现方式:让 AI 来选择。

快速开始 核心概念
"除了意图之外的一切都是选择。"
Why、What 和 Not 属于你。其余的交给 AI。

01 — 问题所在

AI 让生成变得廉价。没有意图,速度只会制造噪音。有了意图,速度便成为清晰。

没有 Intent

  • AI 选择了你从未要求的技术栈
  • AI 编造了无人需要的时间线
  • AI 膨胀了规格说明、用户故事和流程
  • 8 个文件,3,740 行,132KB 的噪音
  • 你仍然不知道什么应该存在

有了 Intent

  • Why:为什么这个必须存在
  • What:什么必须成立
  • Not:AI 不能越过的边界
  • 1 个文件,47 行,纯信号
  • AI 执行而非猜测

02 — 框架

一份 Intent 文档有四个部分,仅此而已。

Why

为什么要做这件事?

阐明问题、目标和成功标准。如果这些改变了,意图就改变了。

What

我们在构建什么?

阐明功能、流程和边界情况。保持具体,但绝不指定技术栈、架构或时间线。

Not

我们永远不做什么?

阐明 AI 不可逾越的红线。范围限制、安全规则、质量标准、禁止的操作。

Learnings

我们发现了什么?

记录你尝试了什么、学到了什么、改变了什么。这是让意图不断锐化的方式。

03 — 生命周期

Intent 不是静态的。它通过学习不断锐化,或因证据而终止。

seed
exploring
clarified
build
killed
← 任何状态都可以在这里终结。这是好事。
# INTENT.md # INTENT — Legacy Converter > status: exploring ## Why Problem: Legacy projects can't leverage vibe coding. Hypothesis: An automated converter can bridge the gap. Validation: Convert one small project, measure dev speed. ## What - [ ] Scan legacy codebase structure - [ ] Generate vibe-coding-ready CLAUDE.md - [ ] Suggest refactoring candidates ## Not Forbidden: Never modify source files without explicit confirmation Scope: Node.js/TS only for now ## Learnings [2026-04-01] Prototype v1 — type coverage was the key signal [2026-04-05] User interview — they want CLAUDE.md generation most

04 — 流水线

人类定义意图并判断结果。AI 负责其余一切。

编写 Intent
编写 Why / What / Not
人类
生成规格说明
AI 将意图转化为任务
AI
💻
实现
AI 代理编写代码
AI
🔍
验证
AI 审查、测试和代码检查
AI
🚀
部署
CI/CD 推送到生产环境
AI
💡
学习与决策
审查结果。更新意图或终止它
人类

05 — 原则

四条规则。违反它们,AI 就会开始猜测。

永远不写 How

Intent 设定约束,而非实现方式。写"不使用外部缓存层",而不是"使用 Redis"。

承认不确定性

用 (?) 标记未知项。诚实的不确定性胜过虚假的精确。

快速终止

如果想法已死,直说并记录原因。一个被终止的 intent 能节省未来的时间。

Intent 精度 = 输出质量

"做一个好应用"是噪音。"新用户在 30 秒内获得价值"才是 intent。

从意图开始。

写下 Why/What/Not。让 AI 选择其余的一切。

快速开始 GitHub
English 한국어 日本語