agentleFS
hellyguohellyguo/self-ai-spec/skills/qualitative-assessment/SKILL.md

qualitative-assessment

Skill8 starsChanged 17 days agoApache-2.0View on GitHub

基于全面分析结果,从设计、开发、运维、非功能等维度对系统做定性评估,识别系统作用领域并给出结论性判断。适用于项目终评、技术方案评审、系统性质总结。

The file

Files
SKILL.md

系统定性评估技能

核心原则:客观、如实、深刻、尖锐,300-500字总结

评估目的

基于 /full-analysis 前四步的客观分析结果,进行定性总结和系统定位:

  1. 这是什么系统?(领域定位)
  2. 系统设计倾向是什么?(面向人 vs 面向机器)
  3. 开发模式是什么?(可扩展 vs 拷贝再开发)
  4. 运维模式是什么?(自动化 vs 全人工)
  5. 非功能属性如何?(健壮性、可维护性、性能)
  6. 这样的设计是否匹配其领域要求?

输入来源

收集前四步技能的输出文件:

  1. /code-deconstruct → 设计文档、ER图、架构图
  2. /code-review → 代码质量、安全、性能问题
  3. /code-detect-dup → 重复度分析
  4. /code-detect-problem → 项目层面问题、重构方案
find docs/ -name "*.md" -type f | grep -E "(deconstruct|review|dup|problem)" | sort -r | head -10

评估维度

1. 设计维度:面向人 vs 面向机器

特征面向人面向机器
交互方式GUI/CLI交互API/消息队列
错误处理友好提示错误码/日志
配置管理配置文件/界面环境变量/启动参数
日志输出人类可读结构化/机器可解析

2. 开发维度:可扩展 vs 拷贝再开发

特征可扩展设计拷贝再开发
架构模式模块化、插件化单体、紧耦合
代码复用抽象接口、继承复制粘贴
配置方式配置驱动硬编码
依赖管理依赖注入直接实例化

3. 运维维度:自动化 vs 全人工

特征自动化运维全人工运维
部署CI/CD流水线手动拷贝文件
监控指标收集、告警人工检查日志
故障恢复自动重启/切换人工干预
配置更新配置中心推送手动修改文件

4. 非功能属性

属性评估要点标准
健壮性错误处理、异常恢复、边界条件防御性编程、降级策略
可维护性代码结构、文档、测试覆盖模块清晰度、注释质量、测试完整性
性能响应时间、资源使用、扩展性算法复杂度、缓存策略、并发处理

5. 领域匹配度

系统类型允许宽松度必须严格的要求
纯小工具面向人、拷贝再开发、全人工功能正确即可
管理类(ERP/OA/录单)弱化性能、简化设计数据一致性、业务流程正确
普通报价(外贸/电商)中等计算准确性、业务逻辑正确
金融报价(股票/期货/外汇)极低高性能、零差错、强实时性、强一致性
量化交易极低高性能、零差错、强健壮性、风控完备
基础设施(数据库/中间件)极低高可用、强一致、可扩展

领域识别线索:业务术语→业务系统,金融术语→金融系统,技术术语→基础设施,工具术语→工具类

注意:金融报价系统等同于量化交易,要求极严格;普通报价系统(外贸/电商)属业务系统,中等严格度即可。

评估流程

步骤1:收集分析结果

# 设计解构:docs/deconstruct/ 下的设计文档与图
deconstruct_file=$(find docs/deconstruct -name "global_design.md" | sort -r | head -1)

# 代码审查:docs/review/code-review-{yyyymmdd}-{seq}-{lang}.md
review_file=$(find docs/review -name "code-review-*.md" | sort -r | head -1)

# 重复检测:docs/dup/dup-{yyyymmdd}-{seq}.txt 或 jscpd HTML 报告目录
dup_file=$(find docs/dup -maxdepth 2 -type f | sort -r | head -1)

# 问题侦测:docs/detect/detect-{yyyymmdd}-{seq}.md
problem_file=$(find docs/detect -name "detect-*.md" | sort -r | head -1)

四个输入缺一不可;缺失时先执行对应技能,不得凭印象补写结论。

步骤2:维度评分(1-5分)

维度5分3分1分
设计完全面向机器,结构化API,完善错误码混合设计,既有API也有界面完全面向人,无机器接口
开发高度可扩展,完整插件体系部分模块化,部分硬编码完全拷贝再开发,高度重复
运维全自动化,完整CI/CD/监控半自动化,关键步骤自动化全人工,无自动化

非功能属性分别按 1-5 分评估:

维度5分3分1分
健壮性异常处理完整,有降级与恢复策略关键路径有异常处理,边界覆盖不全异常吞没或未处理,故障即中断
可维护性模块清晰、文档完整、测试充分结构基本清晰,文档或测试有缺口结构混乱、无文档、几乎无测试
性能有容量规划与基准数据,无明显热点满足当前负载,缺少量化数据存在明显瓶颈或资源泄漏

步骤3:领域识别和匹配度判断

  1. 提取项目关键词 → 分析主要业务逻辑 → 判断系统核心价值 → 匹配领域分类
  2. 匹配度:匹配(一致)/ 部分匹配(某些维度不符但可接受)/ 不匹配(关键维度严重偏离)

步骤4:生成尖锐总结

总结结构:一句话定性 → 设计倾向 → 开发模式 → 运维现状 → 非功能短板 → 领域匹配度 → 风险提示 → 改造建议

语言风格:客观(基于事实)、如实(不回避问题)、深刻(看到本质)、尖锐(直指要害但建设性)

输出格式

本文件中的 templates/... 均指本技能目录下的 templates/ 子目录。

  • 文件命名:docs/assessment/qualitative-assessment-{yyyymmdd}-{seq%000}.md
  • 报告模板:templates/assessment-report.md

执行方式

# 作为full-analysis第五步
/long-term-task 连续执行下列任务
1. skill /code-deconstruct
2. skill /code-review
3. skill /code-detect-dup
4. skill /code-detect-problem
5. skill /qualitative-assessment

# 独立使用(已有分析结果时)
/qualitative-assessment

验证标准

  1. 客观性:所有结论有数据支持
  2. 深刻性:不止于表面现象,看到本质
  3. 尖锐性:不回避问题,直指要害
  4. 建设性:批评的同时给出改进方向
  5. 简洁性:总结在300-500字内

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.