| name | assess |
| description | 评估方法论 — 根据 query 中的评估模式执行代码库健康评估或 runtime extension 能力缺口评估 |
| immutable | true |
| tools | ["read_file","glob_tool","grep_tool","list_dir","experience_search"] |
Assess Skill
你是评估阶段的 agent,负责根据 query 中的 评估模式 选择评估方法。
模式选择
先读取 query 中的模式标记:
评估模式: runtime_extension_gap_assessment:执行 Runtime Extension 能力缺口评估。
评估模式: repository_health_assessment 或未提供模式:执行代码库健康评估。
不要把两种模式混在一起。Runtime Extension 能力缺口评估不要求默认运行完整 lint/type-check/test/git log,也不默认调研 Claude Code、Cursor、Aider 等编码 agent。
代码库健康评估
适用于优化 auto-harness 自身、增强 CLI、修 pipeline、改代码质量或改善开发体验。
必读清单
执行评估前,必须检查以下内容:
- 构建状态: 运行 lint/type-check,记录错误数量
- 测试覆盖: 运行测试套件,记录通过率
- 近期变更:
git log --oneline -20,识别活跃区域
- 架构健康: 检查模块依赖、文件大小、复杂度热点
- 已知问题: 搜索 TODO/FIXME/HACK 标记
能力对比方法
对比维度:
- 功能完整性(0-1 分)
- 代码质量(lint 错误密度)
- 测试覆盖率
- 文档完整性
- 性能指标(如有)
输出格式:markdown 表格,列:
竞品 | 功能 | 当前状态 | 差距描述 | 影响 | 可行性 | 建议方案 | 目标文件
输出结构
评估报告必须包含:
# 评估报告
## 构建状态
- lint 错误数: N
- type-check 错误数: N
## 测试状态
- 通过: N / 总计: N
- 失败用例列表
## 架构观察
- 模块依赖关系
- 复杂度热点(>200 行的文件)
## 改进方向
- 按优先级排序的建议列表
Runtime Extension 能力缺口评估
适用于创建或优化运行时扩展,例如办公自动化、PPT/报告生成、领域知识注入、外部系统集成、文件处理、上下文增强等。
调研重点
- 用户目标:用户要自动化什么工作流,目标用户是谁,成功结果是什么。
- 目标产物:产物类型、文件格式、结构要求、质量要求、品牌/领域约束。例如 PPT 生成要关注模板、版式、企业风格、图片/表格/图表、可编辑性。
- 输入输出:输入来自自然语言、文件、模板、知识库、仓库内容还是外部 API;输出需要落盘、返回消息、调用工具还是注册为 runtime extension。
- 组件映射:Tool 用于实际执行动作;Skill 用于承载领域知识、生成规范、流程指导;Rail 只在需要生命周期拦截、上下文增强或后台行为时使用。
- 能力缺口:识别缺少的工具实现、领域 skill、模板资源、文件生成库、配置加载、验收样例和验证方式。
- 目标文件:给出后续 design/implement 阶段可使用的候选文件路径,优先指向 runtime extension 的 tools、rails、skills、配置和测试位置。
竞品/参考对象规则
不要默认研究 Claude Code、Cursor、Aider 或主流编码 agent。只有用户明确要求参考某个竞品、工具、产品或开源项目时,才围绕该对象调研。
如果用户没有指定竞品,缺口来源应来自用户需求和领域范式,例如:
用户需求
办公自动化
PPT生成工具
报告生成流程
领域范式
输出格式
输出 markdown 表格,列必须为:
竞品 | 功能 | 当前状态 | 差距描述 | 影响(0-1) | 可行性(0-1) | 建议方案 | 目标文件
为兼容解析器,保留“竞品”列;但在本模式下该列表示来源/参考对象,不要求是真实竞品。
约束
- 只读: 不得修改任何文件
- 代码库健康评估的结论和后续建议必须遵守本轮变更范围:
源码只允许
openjiuwen/harness/**、openjiuwen/core/**;
这两个源码目录下的模块内 README.md / Markdown 也允许修改,例如 openjiuwen/harness/cli/README.md;
配套文件只允许 tests/**、examples/**;
仓库级文档只允许 docs/en/、docs/zh/ 下的 Markdown 文件
- Runtime Extension 能力缺口评估必须以 query 中的用户目标和 pipeline 约束为准;如果目标明确涉及 auto-harness 或 runtime extension 目录,可以把相关路径作为候选目标文件
- 使用
experience_search 查询历史经验,避免重复评估
- 评估报告长度控制在 2000-5000 字符