Agent Skills
返回列表
🤖

文档优先流式编程

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/stream-coding-rr4c 到当前 AI 助手中。

技能介绍

要解决的问题

AI 编码助手最常见的失败不是「写不出代码」，而是写到一半停下来反问需求。规格文档含糊、遗漏边界条件、把作者的假设写成事实——这些问题在代码生成阶段才暴露时，往往已经演变成难以定位的 bug。多数方案盯着代码生成这一步，而真正的瓶颈在上游：文档本身不够 AI 友好。

它如何工作

核心思路是把文档当作唯一事实来源，代码只是文档的「打印输出」。该技能用一道双闸门流水线把关规格质量：

  • Spec Gate（13 项清单）：检查结构性完整性，回答「AI 能否照着这份文档直接执行、无需追问」。
  • Clarity Gate（9 项，独立工具）：检查表述清晰度，回答「AI 是否会把假设误当成事实」。
  • 对抗评审（Phase 2.5）：引入一个「唱反调」的批评者，在执行前用恶意视角压力测试规格。

完整流程为 Spec Gate → Clarity Gate → 对抗评审 → 已验证规格 → 执行，时间分配为 40/40/5/10/5——大部分时间花在文档上，而非代码上。

适用边界

  • 它不替你写代码，也不能弥补缺失的领域知识，文档质量仍是前提。
  • Clarity Gate 是独立工具，本技能只覆盖 Spec Gate 与对抗评审的流程设计。
  • 规格通过闸门后，涉及外部依赖与数据模型的关键决策仍需人工 review。
  • 对一次性的探索性原型，这套流程成本偏高，更适合需求稳定、需要反复生成的任务。

使用场景

  • 准备让AI代理照着规格实现功能，担心文档含糊导致AI中途反问需求时，用Spec Gate清单逐项自查。
  • 团队要把需求文档交给AI编码助手，担心AI把作者的假设当成事实执行时，先用Clarity Gate检查表述歧义。
  • 规格文档即将交给AI执行前，需要从恶意视角压力测试、找出漏洞和边界遗漏时，启动Phase 2.5对抗评审。
  • 在迭代开发流程中，想把质量把关前移到文档阶段，验证通过再进入代码生成时，套用这套双闸门流水线。

适合人员

  • AI应用开发者——需要频繁把需求文档交给编码代理执行，苦于AI中途反问需求导致的返工。
  • 技术负责人——负责审查团队提交的规格文档质量，希望用客观清单把关文档的AI可执行性。
  • 独立开发者——一人承担产品全生命周期，想先验证文档再生成代码，减少反复调试的成本。
  • 测试工程师——需要在代码生成前从恶意视角评审规格的边界和漏洞，需要一套正式的对抗评审流程。