用途
该技能是“纪律化开发”流程中的质量评估环节,位于第 1.5 与 2.5 阶段。它在研究文档(第 1 阶段)与实施计划(第 2 阶段)进入下一阶段之前,使用 KLS(Krogstie-Lindland-Sindre)六维框架对文档质量进行评估,并检查精要主义对齐情况。
主要能力
- 使用 KLS 六维框架评估文档质量:物理(可读性、格式、可访问性)、经验(目标受众能否理解,清晰度、术语、示例)、句法(内部一致性、结构、完整性)、语义(是否准确代表领域,准确性、正确性、领域契合度)、实用(能否促成预期决策或行动,可操作性、有用性、指导性)、社会(利益相关者是否认同内容,共识、评审状态、批准情况)。
- 采用 1-5 分制评分:1 差、2 低于标准、3 合格、4 良好、5 优秀。
- 应用质量门阈值:任一维度不得低于 3 分,所有维度平均分不得低于 3.5 分,且为阻塞式门禁,未通过则阻止阶段转换。
- 执行精要主义检查:关键少数聚焦(是否聚焦 5 个或更少关键项)、已消除噪音(是否有明确的“范围外”部分)、最简路径(提议路径是否尽可能简单,是否存在过度工程)、90% 规则(每项是否通过“HELL YES”测试)。
- 输出结构化评估报告,包含执行摘要、KLS 各维度得分与理由、平均分与最低分、精要主义评估、GO/NO-GO 决策、必需修复项、建议改进项、表彰项与复评清单。
使用方式
在以下时机使用:第 1 阶段(研究)之后、第 2 阶段(设计)之前;第 2 阶段(设计)之后、第 3 阶段(实施)之前;审查任何技术文档质量时;验证范围纪律时。
评估流程:
- 文档接收:识别文档类型(研究文档/实施计划),记录请求的阶段转换,收集利益相关者背景。
- KLS 维度评分:对每个维度阅读相关章节、应用评分指南、记录理由;若得分低于 3 分,明确所需修复。
- 精要主义审查:统计范围项(应不超过 5 个),验证消除文档是否存在,评估提议方法的简洁性,质疑任何边缘纳入项。
- 决策:应用 GO/NO-GO 规则确定状态。
GO/NO-GO 规则:
- 自动失败(阻塞):任一 KLS 维度低于 3 分;平均分低于 3.5 分;包含非必要范围(违反关键少数);超过 5 个主要组件且无明确理由;需要英雄式努力才能实施。
- 有条件通过:所有维度不低于 3 分,平均分不低于 3.5 分;存在轻微精要主义问题(已记录);建议可审查的改进(非阻塞)。
- 通过:所有维度不低于 4 分;平均分不低于 4.0 分;所有精要主义检查通过;无必需修复。
与其他技能的集成:
- 第 2 阶段(设计)之前:disciplined-research -> disciplined-quality-evaluation -> disciplined-design
- 第 3 阶段(实施)之前:disciplined-design -> disciplined-quality-evaluation -> disciplined-implementation
- 与 quality-gate 技能配合:quality-gate 技能在审查研究或设计文档时,将文档质量评估委托给本技能。
适用场景
- 研究文档进入设计阶段前的质量把关。
- 实施计划进入实施阶段前的质量把关。
- 审查任何技术文档的质量。
- 验证范围纪律,防止范围蔓延。
限制
- 评分必须有证据,无理由不得评分。
- 必需修复必须具体且可操作。
- 必须遵守阈值,不得让低于阈值的文档通过。
- 必须检查精要主义,范围纪律是强制性的。
- 成功指标:通过评估的文档在后续阶段成功;必需修复清晰到足以实施;只有质量文档才能进行阶段转换;范围蔓延在实施前被捕获。