@peterxiaoyang/superspec 0.1.35 → 0.1.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@peterxiaoyang/superspec",
3
- "version": "0.1.35",
3
+ "version": "0.1.36",
4
4
  "description": "SuperSpec 流程引擎 — transition engine with lightweight fact-sync",
5
5
  "type": "module",
6
6
  "engines": {
@@ -19,7 +19,7 @@ metadata:
19
19
  3. 登记结果。
20
20
  4. 回到第 1 步。
21
21
 
22
- 如果 next 返回用户确认、审查或验证事项,停止当前 apply 推进,并按 next 交给对应工作项或用户确认处理。处理完成前不要继续下一个 task,也不要进入下一阶段。对用户说明时使用自然语言,不默认复述内部 JSON 字段或完整工作项说明。
22
+ 如果 next 返回用户确认、审查或验证事项,停止当前 apply 推进,并按 next 交给对应工作项或用户确认处理。处理完成前不要继续下一个 task,也不要进入下一阶段;任务完成时说明改动、RED/GREEN no-TDD 证据和下一步;发现范围、验收或用户可见行为变化时,停止实现并说明要回 propose。
23
23
 
24
24
  ## 普通 task 执行
25
25
 
@@ -18,7 +18,7 @@ metadata:
18
18
  2. 执行返回的命令
19
19
  3. 回到 1
20
20
 
21
- 如果下一步提示还有用户确认、审查或验证事项,先完成这些事项。完成前不要归档或宣布流程完成;对用户说明时使用自然语言,不默认复述内部 JSON 字段或完整 packet
21
+ 如果下一步提示还有用户确认、审查或验证事项,先完成这些事项。完成前不要归档或宣布流程完成;只说明等待确认、缺失事项或归档完成;归档完成时说关键文档和证据记录已保全,默认不展开指纹、raw manifest
22
22
  如果 next 返回 `archive_confirmation`,不要自行确认;只有用户明确要求归档时才执行 archive。
23
23
 
24
24
  ## 本阶段做什么
@@ -19,9 +19,9 @@ metadata:
19
19
  3. 登记结果
20
20
  4. 回到 1
21
21
 
22
- 如果下一步提示当前阶段还有用户确认、审查或验证事项,先完成这些事项。完成前不要进入下一阶段,也不要修改业务代码;对用户说明时使用自然语言,不默认复述内部 JSON 字段或完整 packet。
22
+ 如果下一步提示当前阶段还有用户确认、审查或验证事项,先完成这些事项。完成前不要进入下一阶段,也不要修改业务代码;就绪或审查后只概括关键事实、真实待确认项和下一步。
23
23
 
24
- 如果下一步说明 discovery 不完整或有未确认问题,先检查并填写 discovery 草稿,不要把草稿占位内容直接转问用户;只有真实阻塞问题才向用户提问,收到回答后优先用 `superspec record user-decision --change "<change>" --input -` 从 stdin 登记 JSON 内容;文件路径模式仍可作为 fallback。
24
+ 如果下一步说明 discovery 不完整或有未确认问题,先检查并填写 discovery 草稿,不要把草稿占位、格式缺口或路径空白直接转问用户;只有影响范围、验收标准、用户可见行为、数据来源或安全边界存在真实阻塞时才向用户提问,收到回答后优先用 `superspec record user-decision --change "<change>" --input -` 从 stdin 登记 JSON 内容;文件路径模式仍可作为 fallback。
25
25
 
26
26
  本技能默认走完整审查路径。探索完成后,`explore → propose` 会先创建 `critic` 工作项,由 Critic 角色审查需求澄清记录。审查完成后优先通过 `superspec record job-submit --change "<change>" --job <JOB> --report -` 从 stdin 登记 JSON 报告内容;文件路径模式仍可作为 fallback。
27
27
 
@@ -19,7 +19,7 @@ metadata:
19
19
  3. 登记结果
20
20
  4. 回到 1
21
21
 
22
- 如果下一步提示当前阶段还有用户确认、审查或验证事项,先完成这些事项。完成前不要进入下一阶段,也不要修改业务代码;对用户说明时使用自然语言,不默认复述内部 JSON 字段或完整 packet。
22
+ 如果下一步提示当前阶段还有用户确认、审查或验证事项,先完成这些事项。完成前不要进入下一阶段,也不要修改业务代码;用户确认只问会改变范围、验收、方案、测试、安全、权限、数据或迁移判断的问题;局部实现细节自行处理;就绪或审查后只概括任务可验证性、关键风险/证据覆盖和下一步。
23
23
 
24
24
  如果下一步需要审查,先按返回的审查说明完成对应审查,再优先用 `superspec record job-submit --change "<change>" --job <JOB> --report -` 从 stdin 提交 JSON 审查报告内容;文件路径模式仍可作为 fallback。
25
25
 
@@ -19,7 +19,7 @@ metadata:
19
19
  3. 登记结果。
20
20
  4. 回到第 1 步。
21
21
 
22
- 如果 next 返回待完成工作项,先完成工作项;如果 next 返回用户确认,先让使用者决策;完成前不要 accept 或 archive。对用户说明时使用自然语言,不默认复述内部 JSON 字段或完整工作项说明。
22
+ 如果 next 返回待完成工作项,先完成工作项;如果 next 返回用户确认,先让使用者决策;完成前不要 accept 或 archive。审查/验证只说明通过与否、阻塞摘要、缺失证据、下一步,以及应回 apply 还是 propose;验收通过时说明等待用户明确确认后再归档。
23
23
 
24
24
  ## review-ready 语义
25
25