| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 1 个月前 | ||
| 4 天前 | ||
| 1 天前 | ||
| 1 个月前 | ||
| 1 天前 | ||
| 2 个月前 | ||
| 1 个月前 | ||
| 15 天前 | ||
| 15 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 9 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 24 天前 | ||
| 23 天前 | ||
| 1 天前 | ||
| 18 天前 |
需求清单（agent-insight 设计文档索引）
本目录收录 agent-insight 的所有需求设计。每个需求一个子目录,内部按三阶段组织:
phase1 需求分析 → phase2 需求设计 → phase3 开发计划。
说明:子目录里的设计文档只描述设计意图,不记录实现进度。「是否实现」这类执行状态统一在本清单跟踪。
少数早期以 spike 形式记录的需求(如 jiuwenswarm-tracing、langfuse-style-trace-search)不按三阶段拆分, 而是
design.md+assets/+ 可选的index.html(给人读的渲染版)。它们原先放在已废弃的docs/designs/目录下,现已并入本目录统一索引。
清单
| 需求名称 | 目录 | 需求描述 | 类型 | 创建时间 | 是否实现 | 对应 issue |
|---|---|---|---|---|---|---|
| Hermes 平台适配（OTel/OTLP 接入） | hermes-otel-adapter | 让运行在 hermes 平台的 Agent 通过标准 OpenTelemetry(OTLP)协议把链路数据上报到 agent-insight,被解析、按会话归并、标记 framework=hermes 并在观测看板呈现;子 Agent 与 skill 对齐 opencode 成为一等公民(可评测/注册/A-B) |
Feature | 2026-06-02 | 🟨 MVP 实现中（仓库内置轻量插件、OTLP JSON 高保真采集与 subagent 关联开发中；原生事件上报作为备用方案） | —（待补） |
| Framework 适配器注册表 | framework-adapter-registry | 把散落在数十处的「按框架走分支」收进统一的 FrameworkAdapter 注册表;第一刀治理三块:skill 抽取重复(4~5 份拷贝)、claude 入库归一化(5 个调用点)、框架名值域不统一(claude/claudecode) |
Refactor | 2026-06-04 | 🟡 实现中（注册表骨架已落地,旧调用点切换与验证待开发） | —（待补） |
| AgentDebug 与 Skills 分析并行化 | agentdebug-parallel-skills-analysis | 将 AgentDebug 主诊断与 Skills 步骤核验拆成独立存储和独立轮询链路,支持点击诊断后并行运行、先完成先展示;不兼容旧 reportJson.skillsAnalysis 数据 |
Feature | 2026-06-05 | ✅ 已实现 | —（待补） |
| Claude Code OTel 工具输出采集补全 | claude-code-otel-tool-output-followup | 记录 Claude Code 官方 OTel logs 中 tool_result 只有 metadata、raw API body file 模式未产出 body_ref、本地 transcript 有工具输出但平台 trace 仍缺 output 的遗留问题;后续需在 OTel traces、raw body file 模式或 Claude native JSONL 补充源之间选定稳定方案 |
Bugfix | 2026-06-10 | ⬜ 未实现（遗留问题已记录,待后续开发） | —（待补） |
| 质量监控结果维度评测 | quality-monitoring | 对 Agent 最终交付按忠实度、指令遵循、答案质量、准确性四项异步评测，持久化证据并为质量报告、趋势和执行记录提供统一分数 | Feature | 2026-06-23 | 🟡 实现中（代码与自动化验证已完成，浏览器验收待确认） | —（待补） |
| 内置 Agent 评估器套件 | build-in-evaluators | 新增回答深度性、轨迹工具利用率和 Agent 工具选择合理性评估，并建立 case 级 Tool/Skill 目录契约 | Feature | 2026-07-27 | 🟡 实现中（代码与自动化验证已完成，浏览器验收待确认） | #163 |
| 标签化版本管理与版本分析 | tag-based-version-management | 通过系统标签、版本标签、业务标签三类标签重构版本管理、链路追踪打标/筛选与版本分析；版本分析只做已有 Trace 指标汇总，不做模型分析 | Feature | 2026-07-06 | 🟡 MVP implemented; browser validation pending | —（待补） |
| Trace 回流到评测数据集 | trace-to-dataset-backflow | 支持 Trace 单条/批量回流到评测数据集、数据集新增自定义字段，以及逐条编辑样本字段值；input/output 使用评测执行已有逻辑处理后写入 | Feature | 2026-07-15 | 🟡 实现中（代码与目标测试已完成，浏览器验收待确认） | —（待补） |
| 评测数据集加载性能优化 | agent-dataset-loading-performance | 为评测数据集增加样本数与参考答案轻量投影，列表和实验导入不再传输完整轨迹，并在数据库层按用户过滤 | Performance | 2026-08-04 | 🟡 实现中 | —（待补） |
| Openclaw 平台适配 | openclaw-adapter | (待补充:定义 Openclaw 平台的接入适配设计,包括链路数据上报、解析及面板呈现等) | Feature | 2026-06-17 | ⬜ 未实现（设计起草中） | —（待补） |
| Trace Bundle 导入导出 | trace-bundle-import-export | 将链路追踪详情导出的 Trace 作为版本化 Bundle 重新导入平台，保留无冲突 ID，并完整恢复多 Agent 父子树 | Feature | 2026-07-15 | 🟡 实现中（代码与自动化验证已完成，浏览器验收待确认） | —（待补） |
| Langfuse Trace 完整展示 | langfuse-trace-fidelity | 为 Langfuse OTLP 增加独立完整节点快照，保留业务 CHAIN/AGENT/TOOL 与真实时序，同时保持其他框架和现有 interactions 行为不变 | Bugfix | 2026-07-21 | 🟡 代码与自动化验证已完成，浏览器验收待确认 | —（待补） |
| 安全与创意预置评估器 | build-in-evaluators | 新增不敏感性、争议性、性别歧视性、创造性 4 个 LLM Judge 预置评估器，专项检测 Agent 输出文本的安全风险与创意质量 | Feature | 2026-07-26 | 🟡 代码与自动化验证已完成，浏览器验收待确认 | #160 |
| JiuwenSwarm 接入追踪（OTEL seam） | jiuwenswarm-tracing | 把 agent-insight 接入 openJiuwen / JiuwenSwarm，通过 OTEL seam 端到端追踪一次执行；含持久化 span spool 与 token 归属边界记录 | Feature | 2026-06-13 | ✅ 已验证（spike 结论已落地，见 design.md status: validated） | —（待补） |
| 链路追踪搜索/过滤改造（langfuse operator 模型） | langfuse-style-trace-search | /trace 列表的搜索与过滤对齐 langfuse 的 operator 模型（搜索栏 + 左侧 facet 侧栏） |
Feature | 2026-06-15 | 🟡 实现中（front-half 已落地：搜索栏 + facet 侧栏 + skill 接线） | —（待补） |
字段口径
- 创建时间:取该需求 phase1 起草日期。
- 是否实现取值:
- ⬜ 未实现 —— 仅有设计,代码未动
- 🟡 实现中 —— 部分落地
- ✅ 已实现 —— 全部落地并通过验收
- 对应 issue:关联的跟踪 issue/工单链接;暂无则填「待补」。
新增需求时的约定
- 在本目录下新建一个短横线命名的子目录(如
xxx-yyy)。 - 子目录内放
phase1-requirements-analysis.md/phase2-requirements-design.md/phase3-development-plan.md。 - 回到本清单追加一行,填齐上表各列。