xuxiang/agents-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
10 Commits 1 Branch 0 Tags
feeafbd70df1ab80d7e22f279e70687acf9b24f1
Commit Graph
10 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
xuxiang feeafbd70d fix(ticket-management): 采纳复核 —— 段位词表补全 + 评论可执行物提示 + 顺序如实判定 
复核回执 R-20260924-103820-a8f2（现状梳理）逐条实跑核对后落地。

【采纳】
- 词表按 #157/#159 真实小节名补齐：`结论`（结论即提案）→ 提案 · `生产实测` → 背景 · `基线` → 效果；
  `取证记录` 进「其他已识别小节」（原报「未归类」是误报）。
- 去掉「更正 / 补充」特例 ⇒ 顺序改按主叙事**如实**判定（复核指出 `## 影响面（实测更正）`
  被错列成「后置小节」）；提示语写明「确为更正小节后置时可保留，由人判断」。
- 缺「提案」的措辞给出路：提示「若『结论即提案』或结论为『无需处置』，请显式写一段声明」。
- 评论清单加 `[可执行]` / `[? 非可执行]` 列（启发式：代码围栏或 SQL 关键字）⇒
  「评论只应剩必须可执行物」由人肉核变为机器提示 + 人核；SKILL §8.1/§8.3 同步。
- `selftest` 13 → **20** 条（补 结论即提案 / 基线归效果 / 取证记录 / 可执行物三态 / 方案明细不被「实测」抢走）。

【自查中自己踩的坑（已修 + 加回归用例）】
- 首版把裸词 `实测` 加进背景词表 ⇒ `## 方案明细（…实测代价）` 被抢归「问题背景」，`#158` 误报「顺序 ⚠」。
  改为 `生产实测`，并加 selftest 锁死该回归。

【不采纳（附理由）】
- 「`闸门=不处置` 作为提案的替代」：闸门是断言 4 的受控词表（等口径 / 等取证 / 等部署），
  新增取值属口径变更且会使「不能开工」语义漂移 ⇒ 改用「`## 结论` 可替代提案 + 正文显式声明」，
  **不动闸门词表**；确要加取值请用户拍板。

【验证 · E1 · 本机】
- `node --check` 通过；`selftest` **20/20**；`verify 157 158 159` = **21/21**。
- `assess`：#158 四段全 ✓ · 顺序 OK · 空壳 无 · 两条评论均判 `[可执行]`；
  #157 四段（结果 / 效果未发生 ⇒ 不长空壳）· 顺序 OK；
  #159 ⇒ **顺序 ⚠**（`影响面` 落在 `机制` 之后）—— 如实判定，前移或按更正小节保留由属主定。
 2026-09-24 10:44:07 +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 47226f78be docs(ticket-management): §6 补一条实测坑 —— 批量改首行须保持 空格-竖线-空格，否则 闸门= 解析失败（断言 4 全线 FAIL） 2026-09-22 16:30:05 +08:00
xuxiang 85ca328690 fix(ticket-management): 首行三级域路径同改半角 - —— 域=L1-L2-L3（断言 3 同步 split(-)；SKILL.md §3.1/§7 同步） 2026-09-22 16:27:48 +08:00
xuxiang 6cd695574b fix(ticket-management): 标题分隔符改半角连字符 - —— 【域-闸门】（用户定：不用 /）；splitTitle 与 rename 同步 2026-09-22 16:22:56 +08:00
xuxiang 9e47a23642 feat(ticket-management)!: 标题改单括号 / —— 【域/闸门】合并为一个括号（废止两括号写法）；splitTitle 按 / 拆 parts，断言 4 改为「/ 后闸门 ∈ 词表 且 = 首行闸门=；可开工不得带闸门」；SKILL.md §2/§7 同步 2026-09-22 16:17:44 +08:00
xuxiang ae6c8d8c2a fix(ticket-management): 自包含判据改用具体前缀（原裸 分析/ 会误伤中文词组，如「进货分析/商品维度」产生假 FAIL）· SKILL.md §7 同注 2026-09-22 16:03:27 +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