|
|
# 05 差异化增强方向
|
|
|
|
|
|
Qoze 已经是“通用 Coding Agent + TUI + Skill/MCP/Subagent”。
|
|
|
你要做成自己的项目，价值不在再做一个更全的 Qoze，而在**更适合你日常的那几刀**。
|
|
|
|
|
|
阶段 5 只选 **1 个主特色**。下面按“值得做 / 以后再说 / 不要做”分组。
|
|
|
|
|
|
## 主特色候选（选一）
|
|
|
|
|
|
### 1. 公司研发工具箱（最贴你的工作）
|
|
|
|
|
|
把内部流程做成工具，而不是让模型瞎猜命令：
|
|
|
|
|
|
- 只读：GitLab 当前用户的 MR 列表、某仓库流水线状态
|
|
|
- 只读：Jenkins 最近一次构建结果（你已有相关 skill 和工作流）
|
|
|
- 写操作必须二次确认：创建 MR、触发构建
|
|
|
|
|
|
为什么这是差异化：通用 Agent 不会懂 hjgit / 公司 CI；这是你的护城河。
|
|
|
|
|
|
注意：密钥走环境变量；工具默认只读；日志不要打印 token。
|
|
|
|
|
|
### 2. Java / Maven 项目大脑
|
|
|
|
|
|
Qoze 的 `analyze_project` / `find_symbols` 偏通用。你可以做深：
|
|
|
|
|
|
- 识别 `pom.xml` 模块结构
|
|
|
- `mvn -q -DskipTests compile` 封装成工具（带确认）
|
|
|
- 失败日志截断后回传模型
|
|
|
- 可选：`jar tf` + 定位依赖冲突（README 提过，源码未必完整）
|
|
|
|
|
|
适合你长期改 Java 仓库。
|
|
|
|
|
|
### 3. 人在回路（HITL）安全层
|
|
|
|
|
|
把 `execute_command` 和文件写入做成审批：
|
|
|
|
|
|
```text
|
|
|
模型提议
|
|
|
→ 终端展示命令 / diff
|
|
|
→ y 执行 / n 拒绝并写回 ToolMessage“用户拒绝”
|
|
|
→ 模型改方案
|
|
|
```
|
|
|
|
|
|
这会立刻比很多开源 Agent 更适合在公司电脑上用。
|
|
|
|
|
|
### 4. Windows 第一公民
|
|
|
|
|
|
Qoze 在 Windows 上有编码、进程组、语音、crontab 一堆坑。你可以：
|
|
|
|
|
|
- 启动强制 UTF-8
|
|
|
- PowerShell 作为默认 shell
|
|
|
- 路径、杀进程按 Win32 做对
|
|
|
- 文档只承诺 Windows Terminal
|
|
|
|
|
|
范围小、但每天都有体感。
|
|
|
|
|
|
## 小增强（主特色稳定后再加）
|
|
|
|
|
|
- `.myagent/rules/` 项目规则（学 `.qoze/rules`）
|
|
|
- git 上下文注入（学 `utils/git_context.py`）
|
|
|
- 一个 Skill：`java-style` 或 `commit-message`
|
|
|
- 流式输出 + 简单思考区（不必上完整 Textual）
|
|
|
- `/compact`：超长对话摘要后截断，控制 token
|
|
|
|
|
|
## 以后再说
|
|
|
|
|
|
- MCP（等你真有一个外部 server 要接）
|
|
|
- Subagent 并行（等单 Agent 经常上下文爆炸）
|
|
|
- 浏览器自动化
|
|
|
- 语音
|
|
|
- 多模型供应商矩阵
|
|
|
|
|
|
这些是 Qoze 变复杂的来源。你没需求就不要搬。
|
|
|
|
|
|
## 不要做
|
|
|
|
|
|
- 把品牌、ASCII logo、文案换个名发布
|
|
|
- 一上来做 Web 版 + TUI 版 + VSCode 插件三端
|
|
|
- 在工具里内置高危操作且无确认（删库、改系统目录、提交并 push）
|
|
|
- 把 Key 写进示例配置提交到 git
|
|
|
|
|
|
## 建议的最终形态（3 个月后）
|
|
|
|
|
|
一句话产品定义，写进你自己的 README 开头：
|
|
|
|
|
|
> 一个跑在 Windows 终端、默认 DeepSeek、对 Java 仓库和公司 CI 友好的个人 Coding Agent；
|
|
|
> 改文件和跑命令前会让我确认；架构我能自己讲清楚。
|
|
|
|
|
|
如果这句你改不动，说明特色还没选明白，先不要写代码。
|
