Install any skill in seconds. Free to start, no credit card required.
Get Started Free →shinpr/requirement-convergence
Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure.
Passed 20 of 25 test cases with the skill, and 11 of 25 without it.
and 11 more in the full report
12 fixed8 passed either way2 still failing3 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 12 test cases the skill fixed. Same model, same prompt, with and without the skill.
我们准备对站内信系统的批量标记已读功能做需求收敛。在开始回答或提问之前,必须先在上下文中完成什么登记操作?
| Checked | Without skill | With skill |
|---|---|---|
| The response explicitly registers the 5 steps and their completion criteria before proceeding. | Missed | Passed |
The instructions your model reads when the skill loads.
收到的需求往往过于臃肿、含糊不清,或指向错误的目标。能力足够的模型会将这三者调和为一个连贯的计划,并忠实地构建它——当被要求的内容本身就是错的时,也精确地交付被要求的内容。
本技能收敛的是要构建什么。如何构建,以及该变更需要哪些文档,都在“要构建什么”确定之后再解决。
| 字段 | 通过条件 |
|---|---|
outcome | 一个可观测的结果。不服务于该结果的需求即为多余。 |
requirements[] | 每个与构建相关的项都标注为 current-state 或 desired-future。 |
nonGoals[] | 由用户撰写,或用户声明没有范围外项。 |
cost | 一个带有结构性依据支撑的分级,加上仍然存在的未知项。 |
cost 是一个粗略的分级,不是工作计划据以排期的工作量估算;需求无法支撑以人天为单位的估算。其未知项在决策权重上比其规模更重要。
依据所保留的用户原话进行分类,而不是依据分析器对原话的转述。要求评估的措辞、描述设想性想法的措辞,或建议某种机制的措辞,在当前收敛上下文中仅作为供判断参考的候选项保留。只有在用户明确确认之后,候选项才能进入 requirements[] 及长期保留的文档。
每个字段都带有各自的就绪标签:ready、weak,或 weak-but-explicit(弱,且用户同意暂不解决)。只有用户可以设置 weak-but-explicit。当所有适用字段都为 ready 或 weak-but-explicit 时,需求即视为已收敛。
各字段的判断规则见:references/criteria.md。
使用现有的范围与成本依据来引出信息并做出判断,然后只就仓库无法回答的产品选择进行提问。requirements[] 和排除项的询问都依据用户提出的能力构建;分析中发现的相邻能力两者都不纳入,因此用户无需拒绝一项自己并未提出的能力。仅当某个答案会改变分析目标或所需的范围依据时,才重新分析范围与成本。
在开始前登记以下步骤,并在每个步骤完成时记录其依据:
| 步骤 | 动作 | 完成依据 |
|---|---|---|
| 1 | 陈述现有的范围事实,然后单独说明这些事实对需求意味着什么 | 列出事实及其分析依据 |
| 2 | 就低于 ready 的字段提问,每条消息最多两个问题 | 每个低于 ready 的字段一个问题 |
| 3 | 将每个答案记录为该字段的值 | 该值是用户明确选定的选项,或用户自己提供的措辞 |
| 4 | 当已记录的值仍未通过其通过条件时,重新询问一次;若用户同意将第二次回答维持原状,则将该字段标记为 weak-but-explicit | 两次已记录的答案,或用户同意停止 |
| 5 | 依据每个字段的通过条件进行判断,并完成该记录 | 一份每个字段都已标注的收敛记录 |
test cases passed, vs 11 / 25 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.