xuxiang/agents-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
9 Commits 1 Branch 0 Tags
79a9c13c91ea4e588989a4d3d64b6c378da5ace3
Commit Graph
4 Commits
Author SHA1 Message Date
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