事先声明:此协议可能会导致 AI 处理任务消耗次数增加。在处理大任务的时候效果最佳
并非小任务不可以执行,在处理较小任务的时候可以添加提示词:请忽略 UADC 协议内容,直接执行 (其实如果任务很小的话,他也不会去执行协议。很奇怪的一个现象,任务复杂度小于协议复杂度的时候他会优先执行任务,任务复杂度大于协议复杂度的时候他会优先执行协议,我没搞懂为什么,也算是 BUG 转 feature 了)
先来解释几个问题
为什么认为 Kiro Spces 模式好。
Spces 核心是将 AI 的工作流完全转向了以文件为中心的 “文档即代码 (Docs as Code)” 模式。这种模式迫使 AI 必须先熟悉全部代码后,制定完整的开发计划。从根源避免了 AI 拿到需求直接上手,导致的各种不可控。
每个任务都管理 requirements.md(需求分析)、design.md(设计方案)、tasks.md (任务文档)不会影响开发效率吗?
当然会,但这些文件并非任务的过程产出,而是 AI 自我 PUA 的过程。他们会成为后续 AI 编码时候的指引,避免 AI 无法完全理解需求,以及出现更多的幻觉。同时也可以让我们知道 AI 是如何看待我们提出的需求的。
协议目前还属于持续迭代阶段,当前 3.2 版本是最稳定版本
需要注意的事
协议中用到了 MCP dynamic-interaction 这是我开发的一个 AI 交互 MCP 目前没有公开,大家可以直接换为 MCP mcp-feedback-enhanced 等MCP。效果完全相同
UADC 协议 3.2:简洁增强版CN.txt (4.3 KB)
UADC 协议 3.2:简洁增强版EN.txt (4.9 KB)
UADC 协议 3.2:内容最佳CN.txt (6.3 KB)
UADC 协议 3.2:内容最佳EN,内容过长部分IDE不支持.txt (8.1 KB)
开发中遇到的问题
AI 可以接受并且识别到协议,但是不遵守 或 忽视协议。
AI模型(尤其是像GPT这样的生成式模型)在处理Prompt时,不是简单地“执行代码”,而是通过上下文理解、模式匹配和概率生成来响应。结构清晰和AI的默认行为匹配上的协议,通常效果会好很多。 复杂性和认知负载过高 的协议,通常AI会选择性忽视。
Prompt 技巧
- 简化结构:缩短Prompt长度(目标<2000 tokens)。用 bullet points 或编号列表替换长段落。
- 强化关键指令:用粗体、重复或伪代码强调“必须”行为。例如,重加通知模式(如果需要),或明确“如果不确定,优先调用MCP审批”。
- 添加角色和自省:开头定义AI角色:“你是严格遵守UADC 2.8的AI代理,专注于生成requirements.md、design.md、tasks.md作为执行依据。”
- 增强示例:为每个阶段添加1-2个完整示例,包括文件生成和MCP消息。
- 处理新概念:将“情境注入”改为AI内部模拟(“在思考时,回忆requirements.md全文”),避免外部依赖。
- 错误处理:添加“如果违反协议,立即停止并报告”。
欢迎大家使用并且提出问题。我会继续迭代。