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` 对三单正文的段位 / 顺序 / 空壳判定与实况相符。
This commit is contained in:
@@ -21,11 +21,18 @@ const SECTIONS = [
|
||||
];
|
||||
const OPTIONAL_SECTIONS = ["验收判据", "反证条件", "遗留"];
|
||||
|
||||
// 取值型选项：`--repo=o/r` 与 `--repo o/r` 两种写法都收（等价；布尔开关不吃后一个参数）
|
||||
const VALUE_OPTS = ["repo", "title", "body-file", "label", "milestone", "token-file", "host", "state", "limit", "domain", "gate", "dump"];
|
||||
function parseArgs(argv) {
|
||||
const pos = [], opt = {};
|
||||
for (const a of argv) {
|
||||
if (a.startsWith("--")) { const i = a.indexOf("="); if (i < 0) opt[a.slice(2)] = true; else opt[a.slice(2, i)] = a.slice(i + 1); }
|
||||
else pos.push(a);
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const a = argv[i];
|
||||
if (!a.startsWith("--")) { pos.push(a); continue; }
|
||||
const j = a.indexOf("=");
|
||||
if (j >= 0) { opt[a.slice(2, j)] = a.slice(j + 1); continue; }
|
||||
const k = a.slice(2), next = argv[i + 1];
|
||||
if (VALUE_OPTS.indexOf(k) >= 0 && next !== undefined && !next.startsWith("--")) { opt[k] = next; i++; }
|
||||
else opt[k] = true;
|
||||
}
|
||||
return { pos: pos, opt: opt };
|
||||
}
|
||||
@@ -138,6 +145,42 @@ function printStructure(body) {
|
||||
console.log(" 空壳段：" + (st.empty.length ? "✗ " + st.empty.join(" · ") + "（删掉或补齐）" : "无"));
|
||||
console.log(" 可选段：" + (st.optional.length ? st.optional.join(" · ") : "无"));
|
||||
}
|
||||
// 自检（不联网、不需要令牌）：node bin/ticket.mjs selftest
|
||||
function cmdSelftest() {
|
||||
let pass = 0, fail = 0;
|
||||
const t = function (name, ok) { if (ok) { pass++; console.log(" PASS " + name); } else { fail++; console.log(" FAIL " + name); } };
|
||||
// —— 解析器：两种写法等价 · 布尔开关不吃后一个参数 ——
|
||||
const p1 = parseArgs(["list", "--repo", "xbc/xbc", "--state=open"]);
|
||||
t("空格写法 --repo xbc/xbc", p1.opt.repo === "xbc/xbc" && p1.pos[0] === "list" && p1.opt.state === "open");
|
||||
const p2 = parseArgs(["verify", "142", "--repo=xbc/xbc"]);
|
||||
t("等号写法 --repo=xbc/xbc", p2.opt.repo === "xbc/xbc" && p2.pos[1] === "142");
|
||||
const p3 = parseArgs(["create", "--repo=xbc/xbc", "--dry-run"]);
|
||||
t("布尔开关不吃后面的参数", p3.opt["dry-run"] === true && p3.opt.repo === "xbc/xbc");
|
||||
const p4 = parseArgs(["comments", "158", "--dump", "_bak.md"]);
|
||||
t("新增取值型选项同规则（--dump）", p4.opt.dump === "_bak.md" && p4.pos[1] === "158");
|
||||
// —— §7 七项断言：合规样例 + 反例 ——
|
||||
const ok = checksOf("【报表-等口径】报表未按经营模式分列", "域=报表-统计-模式分列 | 闸门=等口径 | 优先级=本迭代 | 类型=数据 | 模式=改造 | 端=后端 | 环境=测服 | 证据=E1" + NL + NL + "正文");
|
||||
t("合规样例 6/6", ok.every(function (c) { return c[1]; }));
|
||||
const b1 = checksOf("【报表】报表未按经营模式分列", "域=报表-统计-模式分列 | 闸门=可开工 | 优先级=本迭代" + NL + NL + "见 codes/foo.go");
|
||||
t("标题无闸门 + 首行 闸门=可开工 ⇒ 断言 4 通过", b1[3][1] === true);
|
||||
t("人读部分含禁用前缀 ⇒ 断言 5 失败", b1[4][1] === false);
|
||||
const b2 = checksOf("【报表-等口径】x", "域=报表-统计-模式分列 | 闸门=可开工");
|
||||
t("标题带闸门但首行 闸门=可开工 ⇒ 断言 4 失败", b2[3][1] === false);
|
||||
const b3 = checksOf("【报表】x", "域=报表-统计-模式分列" + NL + NL + "<!-- refs:");
|
||||
t("有引用块无 ref-owner ⇒ 断言 6 失败", b3[5][1] === false);
|
||||
// —— §8 结构评估：四段齐 / 缺必备段 / 空壳 / 乱序 ——
|
||||
const sOk = structureOf("域=平台-性能-索引" + NL + NL + "## 现象" + NL + "坏。" + NL + NL + "## 方案" + NL + "修。");
|
||||
t("背景 + 提案齐 ⇒ 顺序 OK", sOk.hits.length === 2 && sOk.ordered === true && sOk.empty.length === 0);
|
||||
const sMiss = structureOf("域=平台-性能-索引" + NL + NL + "## 现象" + NL + "坏。");
|
||||
t("缺必备段（提案）可被识别", sMiss.hits.some(function (x) { return x.idx === 1; }) === false);
|
||||
const sEmpty = structureOf("域=平台-性能-索引" + NL + NL + "## 现象" + NL + "坏。" + NL + NL + "## 处置结果" + NL + NL + "## 遗留" + NL + "x");
|
||||
t("空壳段可被识别", sEmpty.empty.length === 1);
|
||||
const sOrder = structureOf("域=平台-性能-索引" + NL + NL + "## 效果对比" + NL + "a" + NL + NL + "## 现象" + NL + "b");
|
||||
t("乱序可被识别", sOrder.ordered === false);
|
||||
console.log("自检 " + pass + "/" + (pass + fail));
|
||||
return fail === 0 ? 0 : 1;
|
||||
}
|
||||
|
||||
async function findTitle(api, repo, title) {
|
||||
const r = await api("/repos/" + repo + "/issues?state=all&type=issues&limit=100");
|
||||
return (Array.isArray(r.j) ? r.j : []).filter(function (x) { return String(x.title || "") === title; });
|
||||
@@ -209,7 +252,7 @@ async function cmdAssess(api, opt, n) {
|
||||
}
|
||||
async function cmdCreate(api, opt) {
|
||||
const title = opt.title;
|
||||
if (!title) { console.log("用法：create --repo=o/r --title=... --body-file=... --label=<id>[,<id>] [--dry-run] [--force]"); return 1; }
|
||||
if (!title) { console.log("用法：create --repo=o/r --title=... --body-file=... --label=<id>[,<id>] [--dry-run] [--force]（--repo o/r 亦可）"); return 1; }
|
||||
const sp = splitTitle(title);
|
||||
if (!sp.parts.length || DOMAINS.indexOf(sp.parts[0]) < 0) { console.log("拒绝：标题主前缀不合规 —— " + title); return 1; }
|
||||
const dup = await findTitle(api, opt.repo, title);
|
||||
@@ -331,7 +374,8 @@ async function cmdRename(api, opt, n) {
|
||||
}
|
||||
|
||||
const USAGE = [
|
||||
"用法：ticket.mjs <子命令> --repo=owner/name [...]",
|
||||
"用法：ticket.mjs <子命令> --repo=owner/name [...]（取值型选项 --x=v 与 --x v 两种写法等价）",
|
||||
" selftest 离线自检（不联网、不需要令牌）",
|
||||
" labels | milestones 读标签 / 里程碑",
|
||||
" list [--state=open|closed|all] 列工单",
|
||||
" verify <n...> 七项断言（有效性：标题/首行/闸门/自包含/引用块/标签）",
|
||||
@@ -347,6 +391,7 @@ const USAGE = [
|
||||
|
||||
const A = parseArgs(process.argv.slice(2));
|
||||
const cmd = A.pos[0];
|
||||
if (cmd === "selftest") process.exit(cmdSelftest());
|
||||
if (!cmd || cmd === "-h" || cmd === "--help") { console.log(USAGE); process.exit(0); }
|
||||
if (!A.opt.repo && !(cmd === "assess" && A.opt["body-file"])) { console.log("缺 --repo=owner/name" + NL + USAGE); process.exit(1); }
|
||||
const api = mkApi(A.opt);
|
||||
|
||||
Reference in New Issue
Block a user