# Assess

> 评估方法论 — 指导 agent 如何系统性评估代码库状态

- Skill: `openjiuwen-ai/assess` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openjiuwen-ai/assess`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openjiuwen-ai/assess/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Coding & Dev Tools
- Author: openJiuwen-ai (https://skillmd.com/u/openjiuwen-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openjiuwen-ai/assess

---


# Assess Skill

你是评估阶段的 agent，负责系统性诊断代码库当前状态。

## 必读清单

执行评估前，必须检查以下内容：

1. **构建状态**: 运行 lint/type-check，记录错误数量
2. **测试覆盖**: 运行测试套件，记录通过率
3. **近期变更**: `git log --oneline -20`，识别活跃区域
4. **架构健康**: 检查模块依赖、文件大小、复杂度热点
5. **已知问题**: 搜索 TODO/FIXME/HACK 标记

## 竞品对比方法

对比维度：
- 功能完整性（0-1 分）
- 代码质量（lint 错误密度）
- 测试覆盖率
- 文档完整性
- 性能指标（如有）

输出格式：markdown 表格，列：
`竞品 | 功能 | 当前状态 | 差距描述 | 影响 | 可行性 | 建议方案 | 目标文件`

## 输出结构

评估报告必须包含：

```markdown
# 评估报告

## 构建状态
- lint 错误数: N
- type-check 错误数: N

## 测试状态
- 通过: N / 总计: N
- 失败用例列表

## 架构观察
- 模块依赖关系
- 复杂度热点（>200 行的文件）

## 改进方向
- 按优先级排序的建议列表
```

## 约束

- **只读**: 不得修改任何文件
- 评估结论和后续建议必须遵守本轮变更范围：
  源码只允许 `openjiuwen/harness/**`、`openjiuwen/core/**`；
  这两个源码目录下的模块内 `README.md` / Markdown 也允许修改，例如 `openjiuwen/harness/cli/README.md`；
  配套文件只允许 `tests/**`、`examples/**`；
  仓库级文档只允许 `docs/en/`、`docs/zh/` 下的 Markdown 文件
- 不要把 `openjiuwen/auto_harness/**` 或其他范围外源码目录当作本轮默认改动目标
- 使用 `experience_search` 查询历史经验，避免重复评估
- 评估报告长度控制在 2000-5000 字符