Skip to content

Commit 7fc94ce

Browse files
committed
feat(output-contract): add density gradient, symbol discipline, desensitization
- §3.1: output density gradient (minimal/standard/full by task count) - §3 DO: multi-task grouping by deliverable, no decorative emoji - §4.6: desensitization self-check (root_cause, scoring internals, gate fields) - develop/SKILL.md: update resource navigation description (zh+en) Context-Checkpoint: B
1 parent c0ca54a commit 7fc94ce

4 files changed

Lines changed: 39 additions & 3 deletions

File tree

skills/en/skills/sopify/develop/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ description: Develop phase entry; routes task execution, state updates, KB sync,
2525

2626
- Long rules: `references/develop-rules.md`
2727
- Shared writing standards: `../references/shared-writing-dna.md` (apply to all output)
28-
- Output contract: `../references/output-contract.md` (required sections, conditional enhancement, self-check)
28+
- Output contract: `../references/output-contract.md` (required sections, density gradient, symbol discipline, desensitization)
2929
- Output templates: `assets/*.md`
3030
- Task extraction script: `scripts/extract_pending_tasks.py`
3131

skills/en/skills/sopify/references/output-contract.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,15 +36,31 @@ Do not force structure on every scenario. Decide whether and how to enhance base
3636

3737
Constraint: use at most one primary structure per reply; avoid stacking table + tree + flow.
3838

39+
### 3.1 Output Density Gradient
40+
41+
Select output density based on scenario complexity. Avoid heavy output for simple tasks:
42+
43+
| Density Level | Applicable Scenarios | Verification Summary |
44+
|--------------|---------------------|---------------------|
45+
| Minimal | quick-fix, single-file change, Q&A | Simplified table (≤3 columns), omit review conclusion |
46+
| Standard | 3-5 task regular develop | Table, omit zero-info columns |
47+
| Full | 6+ tasks or cross-module delivery | Full table + phased review conclusions |
48+
49+
Density level is auto-inferred from task count and change scope; no user specification needed.
50+
3951
**DO:**
4052
- Use a comparison table when multi-option tradeoffs are present — make differences visible at a glance
4153
- Simplify verification summary on success when all passed — omit columns with no information
4254
- Keep plain text when information shape does not match any structure
55+
- Trim output by density gradient: quick-fix should not produce a full verification table
56+
- Group by deliverable when completing 3+ independent tasks; merge same conclusions into one line
57+
- No decorative emoji in body text (verification summaries, review conclusions, Changes section)
4358

4459
**DON'T:**
4560
- Multi-option tradeoffs without comparison structure = missed enhancement
4661
- Forcing tables on simple Q&A = over-enhancement
4762
- Mixing two or more primary structures in one reply = cognitive overload
63+
- Expanding 5 identical `passed` conclusions item-by-item = information dilution
4864

4965
## 4. Pre-output Self-check
5066

@@ -54,3 +70,5 @@ Before outputting the final reply, verify:
5470
2. Status symbol correct: `` only when all verifications passed with no degradation or skips; otherwise `!`.
5571
3. Footer complete: `Changes:` + `Next:` must be present.
5672
4. Conditional enhancement applied: if the reply meets a §3 trigger condition, use the corresponding structured format.
73+
5. Density level matched: quick-fix should not produce a full verification table; complex delivery should not lack review conclusions.
74+
6. Desensitization: rewrite raw `root_cause` enums as human descriptions; do not expose internal scoring weights; do not display gate/handoff JSON fields (`resolution_id`, `run_stage`, etc.).

skills/zh/skills/sopify/develop/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ description: 开发实施阶段入口;聚合任务执行、状态更新、知
2525

2626
- 长规则:`references/develop-rules.md`
2727
- 共享写作规范:`../references/shared-writing-dna.md`(所有输出遵循)
28-
- 输出契约:`../references/output-contract.md`(必需 section、条件增强、自检
28+
- 输出契约:`../references/output-contract.md`(必需 section、密度梯度、符号纪律、脱敏规则
2929
- 输出模板:`assets/*.md`
3030
- 任务提取脚本:`scripts/extract_pending_tasks.py`
3131

skills/zh/skills/sopify/references/output-contract.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222

2323
表格列约束:只展示当前场景有信息量的列。列省略只影响最终展示,不影响内部验证判断。`reason_code` 是内部验证字段,不在用户面输出中展示。
2424

25-
## 3. Conditional Enhancement & Format Selection
25+
## 3. 条件增强与格式选择
2626

2727
不强制所有场景结构化。按信息形状和触发条件决定是否增强、用什么结构:
2828

@@ -36,15 +36,31 @@
3636

3737
约束:同一回复最多选一种主结构,避免表格 + 树 + 流程叠加。
3838

39+
### 3.1 输出密度梯度
40+
41+
按场景复杂度选择输出密度,避免简单任务输出过重:
42+
43+
| 密度级别 | 适用场景 | 验证摘要形式 |
44+
|---------|---------|------------|
45+
| 精简 | quick-fix、单文件修改、咨询问答 | 简化表格(≤3 列),省略复审结论 |
46+
| 标准 | 3-5 任务的常规 develop | 表格,省略无信息量列 |
47+
| 完整 | 6+ 任务或跨模块交付 | 完整表格 + 分阶段复审结论 |
48+
49+
密度级别由任务数和改动范围自动推断,不需要用户指定。
50+
3951
**DO:**
4052
- 满足多方案取舍时用对比表,让差异一目了然
4153
- success 全部 passed 时简化验证摘要,省略无信息量列
4254
- 信息形状不匹配任何结构时保持纯文本
55+
- 按密度梯度裁剪输出:quick-fix 不输出完整验证表
56+
- 3+ 独立任务时按交付物分组输出,同类结论合并为一行
57+
- 正文(验证摘要、复审结论、Changes 区)不使用装饰性 emoji
4358

4459
**DON'T:**
4560
- 满足多方案取舍却无对比结构 = 漏增强
4661
- 强制在简单问答上叠加表格 = 过度增强
4762
- 同一回复混用两种以上主结构 = 认知过载
63+
- 5 个任务结果逐项展开相同 `passed` 结论 = 信息稀释
4864

4965
## 4. 输出前自检
5066

@@ -54,3 +70,5 @@
5470
2. 状态符是否正确:`` 仅当全部验证通过且无降级/跳过;否则必须 `!`
5571
3. footer 是否完整:`Changes:` + `Next:` 必须存在。
5672
4. 条件增强是否触发:如当前回复满足 §3 增强触发条件,应使用对应结构化表达。
73+
5. 密度级别是否匹配:quick-fix 不应输出完整验证表;复杂交付不应缺少复审结论。
74+
6. 脱敏:`root_cause` 枚举值转人话描述;内部评分权重不外露;gate/handoff JSON 字段(`resolution_id``run_stage` 等)不展示。

0 commit comments

Comments
 (0)