angel291592/Intent-Router

解决的问题

它消除了 AI 智能体中常见的“猜测”和“无休止的访谈”。该工具不像智能体那样去猜测您的意图或询问几十个问题，而是像编译器处理代码一样处理意图：它探测现有数据（代码、文档、工单）以解决歧义，仅询问真正需要人类判断的那一个问题，如果请求仍然过于模糊，它会拒绝执行。

工作原理

它通过三个步骤处理请求：

1. 解析 (Parse)：将您的请求转换为草稿 IntentSpec（结构化计划）并识别缺失的信息。
2. 解析 (Resolve)：对每一项缺失的信息进行分类。如果答案存在于您的仓库、文档或日志中，它会自动探测。如果答案需要人类决策（如权衡或不可逆的操作），它会询问您一次。
3. 类型检查与输出 (Typecheck & Emit)：如果请求说明不足，它会停止。如果继续，它会保存一个机器可读的 IntentSpec 文件，作为未来会话的契约，确保智能体不会“忘记”您的决策。

适用人群

希望构建更可靠的 AI 智能体，并希望尊重现有项目约束、避免不必要的用户中断，以及在不同会话间维护持久且可验证的决策记录的开发者和团队。

亮点

• 自动探测 (Automated Probing)：自动搜索您的仓库、git 历史记录和文档来回答问题，而不是打扰用户。
• 持久契约 (Persistent Contracts)：将每个意图保存为 .intent.yaml 文件，允许未来的智能体或团队成员从您既定的决策开始，而不是从零开始。
• 安全门 (Safety Gates)：如果请求模糊或触及不可逆的边界，则拒绝执行，防止智能体做出危险的“猜测”。
• 验证 (Verification)：根据原始的 IntentSpec 检查最终交付的工作，以确保智能体确实遵循了商定的约束。
• 零安装 (Zero-Install)：设计为一种可移植的技能，无需复杂的基础设施即可添加到现有的智能体工作流中。