coder-xieshijie/dev-skills / skills/core-spec
core-spec
VerifiedConverges a conversation and its materials into spec.md, the core decisions; when delivery will be automated, also writes verify.md, the acceptance requirements. Use after discussion and clarification are finished, including when the user confirms core-grill's decision summary.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 28.4 KB |
| agents/openai.yaml | config | 154 B |
| references/cross-model.md | markdown | 6.6 KB |
| references/gap-check.md | markdown | 7.2 KB |
| references/spec-example.md | markdown | 8.9 KB |
| references/verify-example.md | markdown | 10.8 KB |
| references/verify.md | markdown | 18.2 KB |
| scripts/clauses.mjs | script | 5.1 KB |
| scripts/clauses.test.mjs | script | 3.2 KB |
| scripts/freeze.mjsexecutable | script | 4.2 KB |
scripts/clauses.mjs
View on GitHub#!/usr/bin/env node
// Clause list for core-spec's gap check (step 7). It numbers every normative
// unit of spec.md so the gap checker can compare spec with verify clause by
// clause instead of section by section. It only lists; it never blocks.
//
// node clauses.mjs --spec <spec.md> [--out <file>]
//
// A unit is a list item (any depth, continuation lines joined), a paragraph,
// or a table body row. Headings, fenced code, blockquotes and table header or
// separator rows are not units. Each unit gets `§<section>-<k>`: <section> is
// the leading number of the nearest heading ("4.1" for "#### 4.1 ...") or the
// heading text when it has no number; <k> counts units under that heading.
//
// Exit 0 on success, 2 on usage errors. Zero dependencies.
import { createHash } from "node:crypto";
import { existsSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
import { fileURLToPath } from "node:url";
const USAGE = "usage: clauses.mjs --spec <spec.md> [--out <file>]";
export function listClauses(text) {
const lines = text.split(/\r?\n/);
const units = [];
let section = "";
let counter = 0;
let current = null;
let fence = false;
const flush = () => {
if (current) {
const body = current.parts.join(" ").replace(/\s+/g, " ").trim();
if (body) {
counter += 1;
units.push({ id: `§${section}-${counter}`, line: current.line, text: body });
}
}
current = null;
};
lines.forEach((raw, index) => {
const lineNo = index + 1;
const line = raw.replace(/\s+$/, "");
if (/^\s*(```|~~~)/.test(line)) {
flush();
fence = !fence;
return;
}
if (fence) return;
const heading = line.match(/^#{1,6}\s+(.*)$/);
if (heading) {
flush();
const title = heading[1].trim();
const number = title.match(/^(\d+(?:\.\d+)*)[.\s]/) || title.match(/^(\d+(?:\.\d+)*)$/);
section = number ? number[1] : title;
counter = 0;
return;
}
if (line.trim() === "") {
flush();
return;
}
if (/^\s*>/.test(line)) {
flush();
return;
}
if (/^\s*\|/.test(line)) {
flush();
const cells = splitRow(line);
const isSeparator = cells.every((c) => /^:?-{2,}:?$/.test(c));
const next = lines[index + 1] || "";
const isHeader = /^\s*\|(\s*:?-{2,}:?\s*\|)+\s*$/.test(next);
if (!isSeparator && !isHeader) {
current = { line: lineNo, parts: [cells.join(" | ")] };
flush();
}
return;
}
const item = line.match(/^\s*(?:[-*+]|\d+[.)])\s+(.*)$/);
if (item) {
flush();
current = { line: lineNo, parts: [item[1]] };
return;
}
if (current) current.parts.push(line.trim());
else current = { line: lineNo, parts: [line.trim()] };
});
flush();
return units;
}
// A table row's cells, split on pipes that are not escaped with a backslash.
function splitRow(line) {
const cells = [];
let cell = "";
const body = line.trim();
for (let i = 0; i < body.length; i += 1) {
const ch = body[i];
if (ch === "\\" && body[i + 1] === "|") {
cell += "\\|";
i += 1;
} else if (ch === "|") {
cells.push(cell.trim());
cell = "";
} else cell += ch;
}
cells.push(cell.trim());
if (body.startsWith("|")) cells.shift();
if (cells.length && cells[cells.length - 1] === "") cells.pop();
return cells;
}
// Escape the pipes that are not escaped yet, so each unit stays in one cell.
function escapePipes(text) {
let out = "";
for (let i = 0; i < text.length; i += 1) {
if (text[i] === "\\" && text[i + 1] === "|") {
out += "\\|";
i += 1;
} else if (text[i] === "|") out += "\\|";
else out += text[i];
}
return out;
}
export function renderClauses(specPath, text, units) {
const hash = createHash("sha256").update(text).digest("hex");
const rows = units.map((u) => `| ${u.id} | ${u.line} | ${escapePipes(u.text)} |`);
return [
"# Spec clause list",
"",
`spec: ${specPath}, sha256 ${hash}, ${units.length} clauses.`,
"",
"| Clause | Line | Text |",
"|---|---|---|",
...rows,
"",
].join("\n");
}
function main(argv) {
const args = {};
for (let i = 0; i < argv.length; i += 1) {
const key = argv[i];
if (key === "--spec" || key === "--out") {
if (!argv[i + 1]) return usage(`${key} needs a value`);
args[key.slice(2)] = argv[i + 1];
i += 1;
} else return usage(`unknown argument: ${key}`);
}
if (!args.spec) return usage("--spec is required");
if (!existsSync(args.spec)) return usage(`spec not found: ${args.spec}`);
const text = readFileSync(args.spec, "utf8");
const out = renderClauses(args.spec, text, listClauses(text));
if (args.out) writeFileSync(args.out, out);
else process.stdout.write(out);
return 0;
}
function usage(message) {
console.error(`${message}\n${USAGE}`);
return 2;
}
// Compare real paths: Skills are usually installed through symlinks, and
// import.meta.url resolves them while process.argv[1] does not.
if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)) {
process.exit(main(process.argv.slice(2)));
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |