Install any skill in seconds. Free to start, no credit card required.
Get Started Free →shinpr/documentation-criteria
Documentation creation criteria including PRD, ADR, Design Doc, and Work Plan requirements with templates.
Passed 21 of 21 test cases with the skill, and 11 of 21 without it.
and 13 more in the full report
11 fixed11 passed either way0 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
对于一个仅包含后端逻辑的计划 20260710-backend-migration,我们需要产出第 1 号任务文件。请给出该任务文件的相对路径与文件名。
| Checked | Without skill | With skill |
|---|---|---|
| The task file is named docs/plans/tasks/20260710-backend-migration-task-01.md. | Missed | Passed |
The instructions your model reads when the skill loads.
本技能负责文档路由:即变更需要记录哪些会对后续工作产生长期影响的决策,以及每种文档存放在何处。“存放位置”中链接的每个模板负责该文档的内容与结构要求。
Accepted 记录的是当前选定的手段,而不是必须保留它的义务:当后续依据表明存在更小且足够的选择时,在已确认成果、目标状态需求和非目标保持成立的前提下,更新或取代该 ADR。完整的实现设计属于设计文档| 结构规模 | 基础文档 | 创建顺序 |
|---|---|---|
| Small(小型) | 无 | 直接实现 |
| Medium(中型) | 设计文档、工作计划 | 设计文档 -> 工作计划 |
| Large(大型) | PRD、设计文档、工作计划 | PRD -> 设计文档 -> 工作计划 |
对于前端/全栈工作,若相关决策尚未确定,应在设计文档之前新增 UI 规范。在设计文档之前完成任何符合条件的 ADR 批次。符合条件的 ADR 会将规模至少提升到中型。
对于 Large(大型)变更,可通过创建新 PRD、更新相关 PRD,或在没有现行产品文档时创建逆向工程 PRD 来满足 PRD 要求。无论规模如何,当产品范围发生变化时都应更新现有 PRD。
按决策负担而非仓库层级来分类。文件数量仅作为辅助依据。
| 规模 | 决策负担 |
|---|---|
| Small(小型) | 单一连贯成果,在单一职责边界内有明显的、有仓库依据支持的实现方式,且不存在会对后续工作产生长期影响的未决选择 |
| Medium(中型) | 单一连贯成果,涉及跨边界协调或包含可能对后续工作产生长期影响的选择 |
| Large(大型) | 多个各自独立产生价值的成果,需要各自独立的设计决策 |
跨层实现如果服务于单一连贯成果,仍可归为 Medium(中型)。
对已确认实现范围内的每个技术主题,依次应用“选择必要性(Choice)”和“长期影响(Durability)”这两个过滤条件。创建新记录前先检查已接受的 ADR。
test cases passed, vs 11 / 21 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.