feat(ticket-management)!: 「任务全貌」四段 → 五段,新增必备段「经验教训」
用户 2026-09-24 指出漏了一个要点:**经验教训**也应是**重点结构**的一部分。 【改动】 - SKILL §8.1:正文骨架加第 ⑤ 段 `## 经验教训`(**必备**,排在 `效果对比` 之后)—— 必须是**可复用结论**(对象 + 动作 / 判据);**尚未定性写「暂无(原因)」**, **不许留空壳,也不许写「加强测试」这类套话**。 - §8.2 闸门 B:**四问 → 五问**(新增「它给出『下次怎么避免 / 怎么做』的可复用结论吗?」)。 - §8.3 整洁性自检:加「经验教训须是可复用结论、非套话;未定性须显式写『暂无(原因)』」。 - §3.2 骨架 / §8.0 定全貌 / §8.1 标题 / §5 assess 表 / §7 分工注 / §8.3 有效性 —— 措辞全部同步。 - `bin/ticket.mjs`:`SECTIONS` 加第 5 段(词表 `经验教训` / `教训` / `复盘`);`assess` 表头改「五段」; **必备段缺失提示按段区分**(教训 ⇒ 指「暂无(原因)」;提案 ⇒ 指「结论即提案 / 无需处置」); `selftest` 20 → **21**。 - `templates/issue.md` 加 `## 经验教训`;README 技能行改「五段任务全貌」。 - (顺带更正)README 里「本机已按此接好 ticket-management」**与实测不符**(本机无该 junction)⇒ 去掉机器特有断言 —— 可复用文档不写本地状态。 【验证 · E1 · 本机】 - `node --check` 通过;`selftest` **21/21**;`grep 四段|四问` ⇒ **0 残留**。 - `assess 158`(真跑)⇒ 五段中**恰好第 ⑤ 段未识别**(正是用户指出的缺口,`#158` 待补经验教训); 顺序 OK · 空壳 无。 - 合成「五段齐」正文 ⇒ 五段全 ✓ · 顺序 OK · 空壳 无。
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
|
||||
| 技能 | 覆盖 | 主要文件 |
|
||||
|---|---|---|
|
||||
| `ticket-management` | Gitea 工单的「人读 + 机读」双面管理,并**始终维护结构有效性与整洁性**:**动工单前先评结构**(四段任务全貌 = 问题背景 / 处置提案 / 处置结果 / 效果对比 → 出「落点表」)· **只记要点**(改不了全貌的不进工单)· 标题问题域前缀 · 正文首行机读 · 正文自包含 · 来源只进末尾机读引用块 · `verify`(有效性)+ `assess`(结构体检)+ 离线 `selftest` | `SKILL.md` · `bin/ticket.mjs` · `templates/issue.md` |
|
||||
| `ticket-management` | Gitea 工单的「人读 + 机读」双面管理,并**始终维护结构有效性与整洁性**:**动工单前先评结构**(五段任务全貌 = 问题背景 / 处置提案 / 处置结果 / 效果对比 / **经验教训** → 出「落点表」)· **只记要点**(改不了全貌的不进工单)· 标题问题域前缀 · 正文首行机读 · 正文自包含 · 来源只进末尾机读引用块 · `verify`(有效性)+ `assess`(结构体检)+ 离线 `selftest` | `SKILL.md` · `bin/ticket.mjs` · `templates/issue.md` |
|
||||
|
||||
## 约定
|
||||
|
||||
@@ -29,7 +29,7 @@ DSH 的技能发现**只有一层**:技能根下的 `<name>/SKILL.md` 或平
|
||||
| 400 | 用户 | `~/.dsh/skills`(即 `$DSH_HOME/skills`) |
|
||||
|
||||
```powershell
|
||||
# 方式一:用户级 —— 所有项目都可见(推荐;本机已按此接好 ticket-management)
|
||||
# 方式一:用户级 —— 所有项目都可见(推荐)
|
||||
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.dsh\skills"
|
||||
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\skills\ticket-management" -Target '<本仓>\ticket-management'
|
||||
|
||||
|
||||
Reference in New Issue
Block a user