xuxiang
47f82dfde8
用户 2026-09-24 交办：工单 skill 在**新建 / 更新**时须**优先评估正文 + 评论该有的结构**，
以合适的安排把关键内容记进工单；**不可事无巨细**，只记能组成「任务全貌」的要点
（**问题背景 / 处置提案 / 处置结果 / 效果对比**）；skill 须**始终维护所编辑工单的结构有效性与整洁性**。
【本轮整改】
- SKILL.md
· 新增**闸门 A「先评结构」**（§8.0 五步 + 落点表）与**闸门 B「只记要点」**（§8.2 四问），
置于 §1 硬规则之首 —— 动工单前的第一动作，不能事后补。
· 重写 §8.1 正文骨架为**四段任务全貌**；③处置结果 / ④效果对比**未发生不写空壳**。
· 新增 §8.3 **有效性 + 整洁性自检清单**，并升为 §1 规则 4（可交付条件）。
· 修 §1 规则 2 与 §2 的自相矛盾（「可选【闸门】」vs「并进同一括号」）⇒ 统一为【域-闸门】。
· §3.2 补四段段序；§7 写明 verify=有效性 / assess=结构 的分工。
- bin/ticket.mjs
· 新增 assess（只读结构体检：四段 / 缺段 / 顺序 / 空壳 + 评论清单）
· update（**标题与正文同一次 PATCH**，过自检才放行）
· comments（清单 / --dump **删前全量备份**）· comment-add · comment-del（**默认只预览**，--yes 才删）。
· create 也先打印结构评估；令牌改**延迟读取**（assess --body-file 无需令牌）。
· 结构判定取「最长词优先」+「同级标题界定空壳」+「更正/补充小节不计顺序」。
- templates/issue.md：改为四段骨架；修 `域=<L1>/<L2>/<L3>` 与 §3.1 / 代码不一致（应为 `-` 分隔）。
- README.md：技能清单说明同步。
【收录此前在途未提交改动】（原属他方；依 86 §13.26 三「待技能属主 / 委托人提交」，本轮一并收束）
- 建单 `--label` 必传 + 断言 7「已带标签」；§1 规则 1b/1c；§8 时间线纪律；§9 实测补充。
【验证 · E1 · 本机】
- `node --check bin/ticket.mjs` 通过。
- `verify 157 158 159 --repo=xbc/xbc` ⇒ **21/21 通过**（七断言未改 ⇒ 向后兼容）。
- `assess --body-file=_body157/158/159.md` ⇒ 段位与顺序判定与三单实际结构相符；
合成反例（缺必备段 + 乱序 + 空壳）三项全部命中。
- `update 159 --dry-run` 与 `comment-del 534`（仅预览）均未落盘。
【遗留】
- 本仓只改文件不推送时，工作树在 `分析/_tmp/`（可删）⇒ 需推送 `origin/main` 才算持久。
- 接入本工作区（`.dsh/skills/agents-skills` junction）依 86 §12.43 属「待产研负责人决定」。
27 lines
1.8 KiB
Markdown
27 lines
1.8 KiB
Markdown
# agents-skills
|
||
|
||
> 可复用的 **agent 技能库**（执行方法，不含项目结论）。每个技能一个**顶层目录** + `SKILL.md`，因此本仓**可以直接作为技能根**（如 junction 到 `<项目>/.dsh/skills` 后由 DSH 发现）。
|
||
|
||
## 技能清单
|
||
|
||
| 技能 | 覆盖 | 主要文件 |
|
||
|---|---|---|
|
||
| `ticket-management` | Gitea 工单的「人读 + 机读」双面管理，且**始终维护结构有效性与整洁性**：**动工单前先评结构**（四段任务全貌 = 问题背景 / 处置提案 / 处置结果 / 效果对比 → 出「落点表」）· **只记要点**（改不了全貌的不进工单）· 标题【问题域】（闸门并入同一括号）· 正文首行机读 · 正文自包含 · 来源只进末尾机读引用块 · `verify`（有效性）+ `assess`（结构体检） | `SKILL.md` · `bin/ticket.mjs` · `templates/issue.md` |
|
||
|
||
## 约定
|
||
|
||
1. **目录式技能**：`<name>/SKILL.md`（**顶层，不嵌套**）—— 嵌套的 `SKILL.md` 不会被技能提供方发现。
|
||
2. **frontmatter 必须有 `name` 与 `description`**；`description` 里写清「什么时候用」，那是唯一发现入口。
|
||
3. **只放「换一个项目还能用吗？能」的东西** —— 项目结论 / 事实不进本仓。
|
||
4. **工具要能自检**：脚本必须能在自己的仓里跑通一条最小用例。
|
||
5. **令牌不落盘**：脚本从 `GITEA_TOKEN` 或 `--token-file` 读，**绝不把令牌写进仓库、URL 或提交**。
|
||
|
||
## 使用（把本仓接到项目）
|
||
|
||
```powershell
|
||
# 方式一：作为技能根之一（Windows 目录 junction）
|
||
New-Item -ItemType Junction -Path '<项目>/.dsh/skills/agents-skills' -Target '<本仓路径>'
|
||
# 方式二：只取一个技能
|
||
Copy-Item -Recurse '<本仓>/ticket-management' '<项目>/.dsh/skills/'
|
||
```
|