zjs105910/workbuddy-market / bundled/novel-writing-suite/skills/story-review
story-review
Verified多视角对抗式审查。full/lean 模式在已部署 reviewer agents 时并行 spawn;缺失/异常 agents 或 spawn 失败时自动降级 solo,参考文件不可读时使用内置 rubric fallback。触发方式:/story-review、/审查、「审查一下」「帮我审一下」。
scripts/normalize-punctuation.js
View on GitHub#!/usr/bin/env node
'use strict';
const fs = require('fs');
const { loadStyleWhitelist, styleSpans } = require('./style-whitelist.js');
const path = require('path');
const USAGE = `Usage: node normalize-punctuation.js [--check] [--quote-mode keep|ascii|yan] <file...>
Normalize正文 punctuation deterministically:
- replace ellipses, em dashes, and double hyphens with Chinese punctuation
- remove markdown divider lines (---) from正文
- preserve pause punctuation covered by book-local .deslop-whitelist literals
- keep quote style by default; convert quotes only when explicitly requested
`;
const options = {
check: false,
quoteMode: 'keep',
files: [],
};
for (let i = 2; i < process.argv.length; i += 1) {
const arg = process.argv[i];
if (arg === '--check') {
options.check = true;
} else if (arg === '--quote-mode') {
const value = process.argv[i + 1];
if (!value) die('--quote-mode requires keep, ascii, or yan');
options.quoteMode = value;
i += 1;
} else if (arg.startsWith('--quote-mode=')) {
options.quoteMode = arg.slice('--quote-mode='.length);
} else if (arg === '-h' || arg === '--help') {
process.stdout.write(USAGE);
process.exit(0);
} else if (arg.startsWith('-')) {
die(`Unknown option: ${arg}`);
} else {
options.files.push(arg);
}
}
if (!['keep', 'ascii', 'yan'].includes(options.quoteMode)) {
die(`Invalid --quote-mode: ${options.quoteMode}`);
}
if (options.files.length === 0) {
die('No files provided');
}
let totalFindings = 0;
let changedFiles = 0;
let failed = false;
for (const file of options.files) {
const fullPath = path.resolve(file);
let input;
try {
input = fs.readFileSync(fullPath, 'utf8');
} catch (error) {
failed = true;
console.error(`${file}: unable to read (${error.message})`);
continue;
}
let whitelist;
try { whitelist = loadStyleWhitelist(fullPath); }
catch (error) { die(`${file}: unable to read .deslop-whitelist (${error.message})`); }
const result = normalizeDocument(input, options.quoteMode, whitelist);
totalFindings += result.findings.length;
if (options.check) {
for (const finding of result.findings) {
console.log(`${file}:${finding.line}:${finding.column}: ${finding.type}: ${finding.message}`);
}
continue;
}
if (result.output !== input) {
fs.writeFileSync(fullPath, result.output, 'utf8');
changedFiles += 1;
console.log(`${file}: normalized (${result.findings.length} issue${result.findings.length === 1 ? '' : 's'})`);
}
}
if (failed) {
process.exit(2);
}
if (options.check && totalFindings > 0) {
process.exit(1);
}
if (!options.check) {
console.log(`Done. Changed files: ${changedFiles}`);
}
function die(message) {
console.error(message);
console.error(USAGE.trimEnd());
process.exit(2);
}
function normalizeDocument(input, quoteMode, whitelist) {
const { lines, endings } = splitLinesKeepingEndings(input);
const findings = [];
const outputLines = [];
let fence = null;
let inFrontMatter = hasYamlFrontMatter(lines);
let quoteOpen = false;
let commentOpen = false;
let commentStart = null;
const commentCloseAhead = new Array(lines.length + 1).fill(false);
for (let index = lines.length - 1; index >= 0; index -= 1) {
commentCloseAhead[index] = lines[index].includes('-->') || commentCloseAhead[index + 1];
}
for (let index = 0; index < lines.length; index += 1) {
const lineNo = index + 1;
const ending = endings[index];
let line = lines[index];
const trimmed = line.trim();
// 未闭合的 `<!--` 不能把余下整篇伪装成注释。确认 EOF 前已无 `-->` 时,
// 在起始位置具名报错,并从当前行恢复正文扫描;起始符所在行仍原样保护。
if (commentOpen && !commentCloseAhead[index]) {
findings.push({
line: commentStart?.line || lineNo,
column: commentStart?.column || 1,
type: 'html-comment-unclosed',
message: 'HTML 注释未闭合;后续内容仍按正文检查。',
});
commentOpen = false;
commentStart = null;
}
if (inFrontMatter) {
outputLines.push(line + ending);
if (index > 0 && trimmed === '---') inFrontMatter = false;
continue;
}
if (fence) {
outputLines.push(line + ending);
if (isClosingFence(line, fence)) fence = null;
continue;
}
const openingFence = parseOpeningFence(line);
if (openingFence) {
fence = openingFence;
outputLines.push(line + ending);
continue;
}
// 跨行 HTML 注释里的 `---` 是注释内容,不是正文分隔线。
if (trimmed === '---' && !commentOpen) {
findings.push({
line: lineNo,
column: line.indexOf('-') + 1,
type: 'markdown-divider',
message: '正文中不要使用 markdown 分隔线;建议移除该行。',
});
continue;
}
const commentOpenBefore = commentOpen;
const punctuationResult = normalizePausePunctuation(line, lineNo, commentOpen, whitelist);
findings.push(...punctuationResult.findings);
line = punctuationResult.line;
commentOpen = punctuationResult.commentOpen;
if (!commentOpenBefore && commentOpen) {
commentStart = { line: lineNo, column: Math.max(1, line.lastIndexOf('<!--') + 1) };
} else if (!commentOpen) {
commentStart = null;
}
const quoteResult = normalizeQuotes(line, quoteMode, quoteOpen, lineNo);
findings.push(...quoteResult.findings);
line = quoteResult.line;
quoteOpen = quoteResult.quoteOpen;
outputLines.push(line + ending);
}
if (commentOpen) {
findings.push({
line: commentStart?.line || lines.length,
column: commentStart?.column || 1,
type: 'html-comment-unclosed',
message: 'HTML 注释未闭合;后续内容仍按正文检查。',
});
}
return {
output: outputLines.join(''),
findings,
};
}
// 逐行记住原始行尾。整篇按「文件里出现过 \r\n」统一行尾会让一个孤立 CRLF 把全文
// 行尾都翻成 CRLF——那是一次没人要求的全文件 diff,而 --check 对行尾一个 finding
// 都不报,只改标点的这一步不该动它。
function splitLinesKeepingEndings(input) {
const lines = [];
const endings = [];
let cursor = 0;
while (cursor < input.length) {
const newlineIndex = input.indexOf('\n', cursor);
if (newlineIndex === -1) {
lines.push(input.slice(cursor));
endings.push('');
break;
}
const crlf = newlineIndex > cursor && input[newlineIndex - 1] === '\r';
lines.push(input.slice(cursor, crlf ? newlineIndex - 1 : newlineIndex));
endings.push(crlf ? '\r\n' : '\n');
cursor = newlineIndex + 1;
}
return { lines, endings };
}
function parseOpeningFence(line) {
const match = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
if (!match) return null;
const marker = match[1];
const rest = match[2];
if (marker[0] === '`' && rest.includes('`')) return null;
return { marker: marker[0], minimumLength: marker.length };
}
function isClosingFence(line, fence) {
const marker = fence.marker === '`' ? '`' : '~';
const match = line.match(new RegExp(`^ {0,3}(${marker}{3,})[\\t ]*$`));
return Boolean(match && match[1].length >= fence.minimumLength);
}
// 删空停顿符会把两侧的半角点/连字符粘成新的 `...`/`--`(`他.……..说` → `他...说`),
// 一遍归一化留不干净,再跑一遍还会改已定稿的正文;所以反复归一化到不动点。
// 每遍至少把一个 `…/./—/-` 换成非停顿字符,字符数严格递减,必然收敛。
// findings 只留第一遍:同一处不重复计数,column 也仍然是原行的偏移。
function normalizePausePunctuation(line, lineNo, commentOpen, whitelist) {
let current = line;
let findings = null;
let commentOpenAfter = commentOpen;
for (;;) {
const comments = htmlCommentSpans(current, commentOpen);
commentOpenAfter = comments.open;
const pass = normalizePausePunctuationPass(current, lineNo, comments.spans.concat(styleSpans(current, whitelist)));
if (findings === null) findings = pass.findings;
if (pass.line === current) break;
current = pass.line;
}
return { line: current, findings, commentOpen: commentOpenAfter };
}
function normalizePausePunctuationPass(line, lineNo, commentSpans) {
const findings = [];
const original = line;
const pattern = /…+|\.{3,}|——|—|--+/g;
let output = '';
let lastIndex = 0;
let match;
while ((match = pattern.exec(original)) !== null) {
const token = match[0];
// HTML 注释是正文里的元信息(如 `<!-- 去味:跳过 -->` 豁免标记):`<!--`/`-->` 里的
// `--` 不是停顿标点,改掉它注释就散了,标记会变成读者看得见的正文。
if (insideSpans(match.index, match.index + token.length, commentSpans)) continue;
output += original.slice(lastIndex, match.index);
const replacement = choosePauseReplacement(original, match.index, token.length);
output += replacement;
findings.push({
line: lineNo,
column: match.index + 1,
type: getPauseType(token),
message: replacement ? `替换为「${replacement}」。` : '移除重复标点。',
});
lastIndex = match.index + token.length;
}
output += original.slice(lastIndex);
return { line: output, findings };
}
// 行内 HTML 注释区间(含 `<!--`、`-->` 本身);注释可跨行,未闭合时把状态交给下一行。
function htmlCommentSpans(line, openBefore) {
const spans = [];
let open = openBefore;
let cursor = 0;
while (cursor < line.length) {
if (open) {
const close = line.indexOf('-->', cursor);
if (close === -1) {
spans.push([cursor, line.length]);
return { spans, open: true };
}
spans.push([cursor, close + 3]);
cursor = close + 3;
open = false;
continue;
}
const start = line.indexOf('<!--', cursor);
if (start === -1) break;
cursor = start;
open = true;
}
return { spans, open };
}
function insideSpans(start, end, spans) {
return spans.some(([spanStart, spanEnd]) => start < spanEnd && end > spanStart);
}
function hasYamlFrontMatter(lines) {
if (!lines[0] || lines[0].trim() !== '---') return false;
let sawYamlField = false;
for (let i = 1; i < Math.min(lines.length, 40); i += 1) {
const trimmed = lines[i].trim();
if (trimmed === '---') return sawYamlField;
if (/^[A-Za-z0-9_-]+:\s*/.test(trimmed)) sawYamlField = true;
}
return false;
}
function getPauseType(token) {
if (token.startsWith('-')) return 'double-hyphen';
if (token.includes('—')) return 'em-dash';
return 'ellipsis';
}
function choosePauseReplacement(text, start, length) {
const before = previousNonSpace(text, start - 1);
const after = nextNonSpace(text, start + length);
const rest = text.slice(start + length).trimStart();
// 正文产物不保留 `……`、`——`、`—` 或 `--`;对话打断和数字区间不设例外。
if (before === '') return '';
// 紧跟开引号/开括号的停顿符号属于句首边界,删空即可,避免产出 `「,…」` 或 `「。」`。
if (isOpeningDelimiter(before)) return '';
if (/\d/.test(before) && /\d/.test(after)) return '到';
if (isClosingQuote(after)) return isSentencePunctuation(before) ? '' : '。';
if (!after) return isSentencePunctuation(before) ? '' : '。';
if (isSentencePunctuation(before) || isPunctuation(after)) return '';
if (/^(因为|原来|这是|那是|也就是|换句话|说白了|所谓|答案|原因|结果|真相|问题在于)/.test(rest)) return ':';
if (/(原因|答案|真相|结果|结论|问题|选择|意思)$/.test(text.slice(0, start).trim())) return ':';
return ',';
}
function previousNonSpace(text, index) {
for (let i = index; i >= 0; i -= 1) {
if (!/\s/.test(text[i])) return text[i];
}
return '';
}
function nextNonSpace(text, index) {
for (let i = index; i < text.length; i += 1) {
if (!/\s/.test(text[i])) return text[i];
}
return '';
}
function isSentencePunctuation(ch) {
return /[,,。.!!??;;::…]$/.test(ch || '');
}
function isPunctuation(ch) {
return /[,,。.!!??;;::、…"“”'‘’」』))]/.test(ch || '');
}
function isClosingQuote(ch) {
return /["”」』]/.test(ch || '');
}
function isOpeningDelimiter(ch) {
return /[「『((“‘]/.test(ch || '');
}
function normalizeQuotes(line, quoteMode, quoteOpen, lineNo) {
if (quoteMode === 'keep') {
return { line, findings: [], quoteOpen };
}
const findings = [];
let output = '';
for (let i = 0; i < line.length; i += 1) {
const ch = line[i];
if (quoteMode === 'ascii' && /[「」『』“”]/.test(ch)) {
output += '"';
findings.push({ line: lineNo, column: i + 1, type: 'quote-style', message: '按显式 quote-mode 转为半角双引号。' });
continue;
}
if (quoteMode === 'yan' && (ch === '"' || ch === '“' || ch === '”')) {
const replacement = quoteOpen || ch === '”' ? '」' : '「';
output += replacement;
quoteOpen = replacement === '「';
findings.push({ line: lineNo, column: i + 1, type: 'quote-style', message: '按显式 quote-mode 转为盐言引号。' });
continue;
}
output += ch;
}
return { line: output, findings, quoteOpen };
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |