Agent Skills
返回列表
开发行为护栏

开发行为护栏

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-dev-guardrails。

技能介绍

问题:当 AI 开始“盲目顺从”

在 AI 辅助编程中,Agent 经常会陷入“盲目顺从”的陷阱。当开发者提出模糊需求(如“做个类似微信的系统”或“我不懂技术,你自己想办法”)时,Agent 往往会为了“表现良好”而疯狂脑补,生成几百行看似合理但完全偏离实际约束的伪代码或无用代码。这种对需求的曲解、架构范围的无限膨胀,以及交付不可运行的代码,是当前工程实践中最致命的痛点。

核心机制:从执行者到项目监督者

为了解决这个问题,dev-guardrails 构建了一个行为护栏约束层。它首先通过双层激活机制工作:Layer 1 对每个请求进行指令拦截,Layer 2 则作为持续运行的项目监督者,维护项目契约并监控范围漂移。

技能遵循五大铁律:

  • 不盲从与不脑补:遇到技术谬误或模糊需求时,强制要求停下来提问,而不是直接写代码。
  • 实事求是与写真实代码:拒绝承诺能力边界外的交付,且输出必须是真实可运行的代码,绝不使用 // TODO 或占位符。
  • 确认再开工:在非微任务前,必须先总结理解、提出方案并等待用户确认。

在 v2.0 项目监督系统 中,它引入了累积范围仪表盘(超过 30% 范围增加触发黄警)和里程碑关卡,确保项目不偏离既定轨道。

适用边界与注意点

这个技能本质上是一个“刹车机制”而非具体的代码生成器。它不替代架构师的决策,也不会帮开发者实现具体的业务逻辑。此外,针对修改不超过 3 个文件、逻辑明确且无架构变更的微任务,它会豁免全流程的确认循环,以保持开发流畅度。在使用时应理解,其核心价值在于降低返工率,而非直接加速编码。

使用场景

  • 用户提出‘做像微信的聊天系统’这类模糊且不合理需求时,需AI先指出问题并提供不同规模替代方案。
  • 开发者连续多次增加小功能导致项目范围累计超30%时,需AI触发范围漂移警报并要求重新确认。
  • 用户说‘随便你定’试图跳过方案确认时,需AI按强制锁定协议要求明确选择或拒绝继续。
  • 架构定稿准备写第一行代码前,需AI执行里程碑关卡审查,确认无偏离已确认架构后再开始。

适合人员

  • 独立开发者,希望AI不要脑补模糊需求,避免生成偏离实际的代码,减少返工。
  • 小团队项目负责人,需要AI监控项目范围漂移,防止频繁加功能导致架构失控。
  • 负责AI编码Agent调试的工程师,需要确保Agent遵循‘确认再开工’原则,不随意输出代码。
  • 经常提出复杂需求的非技术用户,希望AI能识别不合理需求并主动提供可行建议,而非盲目执行。