xuxiang/agents-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
11 Commits 1 Branch 0 Tags
main
Commit Graph
5 Commits
Author SHA1 Message Date
xuxiang a70eaae125 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 · 空壳 无。
 2026-09-24 10:50:33 +08:00
xuxiang 79a9c13c91 merge: 结构评估先行（本席 47f82df）+ 参数两写法 / selftest / DSH 接法（bae7302） 
两条并行改动落在同一批文件上 ⇒ 逐个文件按「谁更对」合入，未整边取用：

【取 bae7302】
- bin/ticket.mjs parseArgs：取值型选项 `--x=v` 与 `--x v` 两种写法都收（本席旧版只认等号）；
  本席新增的 `--dump` 一并纳入 VALUE_OPTS。
- bin/ticket.mjs `selftest`（不联网、不需要令牌）—— 本席在其上补 4 条 §8 结构判定用例（共 13 条）。
- README「接到 DSH」整节：技能发现只有一层、逐技能 junction、rank 表、用户级接法
  （本席原稿「整仓当作技能根」是错的，已弃）。
- SKILL §6「参数写法的坑（已修 · 留档）」；templates 的「域内层级用 - 而非 /」提示行。

【取本席】
- SKILL：闸门 A 先评结构（§8.0）+ 闸门 B 只记要点（§8.2）+ 四段任务全貌（§8.1）
  + 结构有效性与整洁性自检（§8.3）；修 §1 规则 2 与 §2 的双括号/单括号自相矛盾。
- bin/ticket.mjs：assess / update / comments（含 --dump 删前备份）/ comment-add / comment-del。
- templates：正文改四段骨架。README：技能清单行。

【同步废止的旧口径】
- SKILL §9「`--repo` 必须用等号形式」⇒ 改为「两种写法都可 · 旧口径已废止」，并指向 §6 成因留档。

【验证 · E1 · 本机】
- `node --check` 通过；`selftest` 13/13；`verify 157 158 159` = 21/21；
- 两种参数写法各跑一次 `verify` 均 7/7；`assess` 对三单正文的段位 / 顺序 / 空壳判定与实况相符。
 2026-09-24 10:26:30 +08:00
xuxiang 47f82dfde8 feat(ticket-management)!: 结构评估先行 —— 四段任务全貌 + 只记要点闸门 + 有效性与整洁性自检 
用户 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 属「待产研负责人决定」。
 2026-09-24 10:21:28 +08:00
hdba4 bae73025f1 fix(ticket-management): 参数两种写法都收 + 新增 selftest + 模板域分隔符改连字符 
- bin/ticket.mjs: parseArgs 同时接受 --x=v 与 --x v（仅取值型选项，布尔开关不吃后一个参数）；
  新增 selftest 子命令（不联网、不需要令牌），覆盖解析器 3 条与断言正反 5 条
- SKILL.md: §5 命令块补 selftest 与「两种写法等价」；子命令表补 selftest 行；
  §6 留档 403/405 假故障的成因（示例写空格、实现只认等号）；frontmatter description 补 selftest
- templates/issue.md: 域层级分隔符 / → -（断言 3 按 - 取 L1，斜杠版照抄必挂）

验证：node bin/ticket.mjs selftest → 8/8，退出码 0
 2026-09-24 10:16:49 +08:00
xuxiang ade5ae5810 feat(ticket-management): Gitea 工单「人读+机读」管理技能（标签零新增 · 标题【问题域】前缀 · 正文首行机读 · 正文自包含 · 末尾机读引用块）+ bin/ticket.mjs（labels/milestones/list/verify/create/rename，含六项断言与建单自检） 2026-09-22 15:48:52 +08:00