# helloagents **Repository Path**: tomahane/helloagents ## Basic Information - **Project Name**: helloagents - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-04 - **Last Updated**: 2026-01-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HelloAGENTS
| **🧭 统一智能路由** 多维度分析实现自动工作流选择: - **语义分析**:理解请求含义,而非仅匹配关键词 - **意图分类**:问答型 / 改动型 / 命令型 - **范围评估**:微(≤2文件)→ 大(架构级) - **EHRB信号检测**:自动风险识别 **你的收益:** 每次都选对工作流——无需手动切换模式。 |
**📊 带评分的需求分析**
代码变更前的结构化验证:
- **10分评分**跨4个维度(目标明确性、预期结果、边界范围、约束条件)
- 评分<7时**针对性追问**
- ` |
| **🔄 阶段与状态管理** 系统化工作流,完整可追溯: - **3阶段工作流**:需求分析 → 方案设计 → 开发实施 - **G12状态变量**:CREATED_PACKAGE、CURRENT_PACKAGE、MODE_* - **G11生命周期管理**:自动迁移到history/ - **上下文保持**:处理追问、选择、确认 **你的收益:** 永不丢失计划与执行的追踪。 | **🛡️ 人性化安全防护** 透明且安全的AI行为: - **G3不确定性原则**:明确假设 + 保守兜底 - **EHRB升级**:检测到风险时自动升级到更严格的工作流 - **统一输出格式**:一致的、经过验证的响应(G6.1) - **符合GPT/SKILLS规范**:规则结构遵循官方指南 **你的收益:** 理解智能体每个决策的原因。 |
| 分析步骤 | 做什么 | 评估标准 | 输出 |
|---|---|---|---|
| 1. 语义分析 |
• 理解请求含义 • 识别动作动词和对象 • 检测隐含需求 |
自然语言理解,非关键词匹配 |
• 请求解释 • 隐含约束 |
| 2. 意图分类 |
• 问答型(提问/聊天) • 改动型(代码变更) • 命令型(~auto/~plan/~exec) |
用户的主要目标 |
• 意图类别 • 命令检测 |
| 3. 范围评估 |
• 微:≤2文件,≤30行 • 小:3-5文件 • 中:多文件协调 • 大:架构级 |
文件数、行数、架构影响 |
• 范围类别 • 不确定标记 |
| 4. EHRB检测 |
• 生产环境信号 • PII数据处理 • 破坏性操作 • 支付相关变更 |
关键词:prod、DROP、rm -rf、支付 |
• 风险级别 • 升级触发 |
| 5. 路由选择 |
• 应用决策原则 • 处理不确定性(G3) • 选择最优工作流 |
简单模式"全部满足";完整研发"满足任一" |
• 选中的工作流 • 推理轨迹 |
| 维度 | 分值 | 衡量什么 | 低分触发词 |
|---|---|---|---|
| 目标明确性 | 0-3 | 任务目标是否清晰具体? | "优化代码"、"让它更好" |
| 预期结果 | 0-3 | 成功标准和交付物是否定义? | 未提及预期行为 |
| 边界范围 | 0-2 | 任务范围是否明确界定? | 开放式请求 |
| 约束条件 | 0-2 | 时间、性能、业务限制是否说明? | 未提及约束 |
| 概念 | 定义 | 为什么重要 |
|---|---|---|
| 语义分析 | 通过NLU理解请求含义,而非关键词匹配 | 即使表述模糊也能准确检测意图 |
| 意图分类 | 将用户请求分类为问答型、改动型或命令型 | 决定路由到问答、开发工作流还是命令执行 |
| 需求评分 | 跨4个维度的10分制评分,≥7分门槛 | 防止在定义不清的需求上浪费精力 |
| 追问机制 | 评分<7时的针对性问题,避免询问已知信息 | 高效的需求收集,无冗余问题 |
| 阶段管理 | 3阶段工作流:分析 → 设计 → 实施 | 确保系统化推进,有明确检查点 |
| 状态管理(G12) | 追踪方案包、模式和上下文的变量 | 在多轮交互中保持一致性 |
| G3不确定性原则 | 明确披露假设和保守兜底 | 透明决策,无隐藏猜测 |
| EHRB检测 | 极高风险行为识别和升级 | 危险操作的自动安全防护 |
本产品包含 "HelloAGENTS"(作者:Hellowind),依据 Apache License 2.0 授权。
2. **文档(README/PROJECTWIKI/图表)** — **CC BY 4.0** © 2025 Hellowind
- 允许商业使用,但**必须署名**;需给出许可链接并标注是否做了修改。
- 复用文档时建议的署名例句:
文本/图表改编自 "HelloAGENTS" —— © 2025 Hellowind,CC BY 4.0。
3. **统一署名建议(代码与文档皆可)**:
HelloAGENTS — © 2025 Hellowind. 代码:Apache-2.0;文档:CC BY 4.0。
---
## 🙏 致谢
**灵感来源:**
- [Mermaid](https://mermaid.js.org/) — 美丽的图表
- [Conventional Commits](https://www.conventionalcommits.org/) — 提交标准
- [Keep a Changelog](https://keepachangelog.com/) — 版本管理
- GPT/SKILLS官方指南 — 规则结构模式
**社区:**
- 所有提交PR的贡献者
- 提供反馈的早期采用者
- 你,读到这里!🎉
---
## 📞 支持与社区
- 📖 **文档**:你正在阅读!
- 💬 **讨论**:[GitHub Discussions](https://github.com/hellowind777/helloagents/discussions)
- 🐛 **Bug报告**:[GitHub Issues](https://github.com/hellowind777/helloagents/issues)
- 💡 **功能请求**:[GitHub Discussions](https://github.com/hellowind777/helloagents/discussions)
---
## 📊 项目统计