Skip to content

code-yeongyu/oh-my-openagent / packages/shared-skills/skills/ulw-research

ulw-research

Unverified

Runs maximum-saturation research with a cooperating team, claim-graph gating, and a cited, QA'd deliverable. Use when the user explicitly asks for research or a deep investigation, including any 'ulw' research wording.

FileKindSize
AGENTS.mdmarkdown9.2 KB
ATTRIBUTION.mdmarkdown2.4 KB
SKILL.mdskill md42.2 KB
references/deliverable-phase.mdmarkdown49.1 KB
references/fact-ledger-grammar.mdmarkdown6.8 KB
references/fact-ledger.mdmarkdown24.4 KB
references/fidelity-claim-kinds.mdmarkdown5.2 KB
references/markdown-blocks.mdmarkdown721 B
references/report-gates.mdmarkdown32.0 KB
references/report-visualization.mdmarkdown15.4 KB
references/research-collection.mdmarkdown26.8 KB
references/research-delivery.mdmarkdown14.3 KB
references/unit-rules.mdmarkdown16.3 KB
scripts/claim-kinds.mjsscript11.2 KB
scripts/claim-kinds.test.tsscript13.5 KB
scripts/claim-prefix.test.tsscript4.9 KB
scripts/claims-index.mjsscript5.3 KB
scripts/claims-index.test.tsscript5.7 KB
scripts/cli-support.mjsscript4.1 KB
scripts/cli-support.test.tsscript4.3 KB
scripts/contracts-validation.test.tsscript3.3 KB
scripts/contracts.mjsscript26.1 KB
scripts/contracts.test.tsscript7.9 KB
scripts/conversion-altered.test.tsscript11.0 KB
scripts/conversion-originals.test.tsscript22.7 KB
scripts/conversion-probe-classes.test.tsscript45.2 KB
scripts/conversion-probe.mjsscript13.5 KB
scripts/conversion-probe.test.tsscript11.6 KB
scripts/copy-returns-fidelity-policy.test.tsscript10.4 KB
scripts/copy-returns-polish.test.tsscript12.1 KB
scripts/copy-returns.test.tsscript10.6 KB
scripts/css-hiding.mjsscript9.1 KB
scripts/css-lite.mjsscript7.6 KB
scripts/css-lite.test.tsscript6.4 KB
scripts/delivery-barrier-meaning.test.tsscript12.3 KB
scripts/delivery-barrier.test.tsscript11.4 KB
scripts/design-spec.mjsscript7.2 KB
scripts/design-spec.test.tsscript6.7 KB
scripts/entities.mjsscript2.5 KB
scripts/entry-guard.mjsscript794 B
scripts/fact-commands-fill.mjsscript6.6 KB
scripts/fact-commands-meaning.mjsscript12.6 KB
scripts/fact-commands-polish.mjsscript10.3 KB
scripts/fact-commands-verify.mjsscript12.6 KB
scripts/fact-commands.mjsscript13.8 KB
scripts/fact-derive-2.test.tsscript7.2 KB
scripts/fact-derive.mjsscript4.9 KB
scripts/fact-derive.test.tsscript10.8 KB
scripts/fact-expr.mjsscript4.5 KB
scripts/fact-fill.mjsscript11.7 KB
scripts/fact-fill.test.tsscript10.7 KB
scripts/fact-ledger-grammar.test.tsscript11.8 KB
scripts/fact-ledger-kinds.mjsscript16.5 KB
scripts/fact-ledger-kinds.test.tsscript9.3 KB
scripts/fact-ledger-legacy.test.tsscript8.9 KB
scripts/fact-ledger-schema.mjsscript11.9 KB
scripts/fact-ledger-schema.test.tsscript1.5 KB
scripts/fact-ledger.mjsscript5.5 KB
scripts/fact-ledger.test.tsscript9.7 KB
scripts/fact-locate.mjsscript12.1 KB
scripts/fact-locate.test.tsscript7.2 KB
scripts/fact-pairs.mjsscript8.3 KB
scripts/fact-pairs.test.tsscript6.6 KB
scripts/fact-recompute.mjsscript4.8 KB
scripts/fact-unit-dimensions-2.test.tsscript8.4 KB
scripts/fact-unit-dimensions.test.tsscript11.9 KB
scripts/fact-unit-rules.test.tsscript8.9 KB
scripts/fidelity-binding.mjsscript6.7 KB
scripts/fidelity-binding.test.tsscript4.0 KB
scripts/fidelity-brief.mjsscript6.4 KB
scripts/fidelity-brief.test.tsscript7.8 KB
scripts/fidelity-claims.mjsscript5.1 KB
scripts/fidelity-csv.mjsscript1.1 KB
scripts/fidelity-lexicon.mjsscript8.1 KB
scripts/fidelity-lexicon.test.tsscript6.0 KB
scripts/fidelity-originals.mjsscript9.9 KB
scripts/fidelity-policy.mjsscript10.1 KB
scripts/fidelity-records.mjsscript13.4 KB
scripts/fidelity-snapshot-readability.mjsscript2.2 KB
scripts/fidelity-sources.mjsscript4.3 KB
scripts/fidelity-state.mjsscript2.1 KB
scripts/fidelity-state.test.tsscript1.7 KB
scripts/fidelity-trace.mjsscript6.1 KB
scripts/fidelity-trace.test.tsscript3.3 KB
scripts/fidelity-value-unit.mjsscript13.3 KB
scripts/fidelity-values.mjsscript16.1 KB
scripts/fidelity-values.test.tsscript15.8 KB
scripts/format-extract-css.mjsscript5.1 KB
scripts/format-extract.mjsscript10.3 KB
scripts/format-extract.test.tsscript11.2 KB
scripts/gates-context.test.tsscript2.6 KB
scripts/gates-fidelity.mjsscript6.3 KB
scripts/gates-fidelity.test.tsscript3.3 KB
scripts/gates-figures.mjsscript9.9 KB
scripts/gates-layout.mjsscript6.6 KB
scripts/gates-layout.test.tsscript12.4 KB
scripts/gates-static-headings.test.tsscript961 B
scripts/gates-static.mjsscript8.1 KB
scripts/gates-static.test.tsscript14.9 KB
scripts/gates-structure.mjsscript4.7 KB
scripts/gates-text.mjsscript7.2 KB
scripts/glossary-vocabulary.test.tsscript1.7 KB
scripts/html-foreign-object.mjsscript2.8 KB
scripts/html-lite.mjsscript9.7 KB
scripts/html-lite.test.tsscript7.9 KB
scripts/html-markup.mjsscript7.0 KB
scripts/html-text-map.mjsscript4.8 KB
scripts/html-text-map.test.tsscript15.2 KB
scripts/layout-probe.mjsscript4.6 KB
scripts/layout-probe.test.tsscript4.2 KB
scripts/lexicon.mjsscript2.6 KB
scripts/lexicon.test.tsscript3.2 KB
scripts/markdown-closers.mjsscript4.9 KB
scripts/md-lite-boundaries.test.tsscript2.2 KB
scripts/md-lite.mjsscript7.8 KB
scripts/md-lite.test.tsscript10.3 KB
scripts/meaning-check.mjsscript9.7 KB
scripts/meaning-check.test.tsscript12.0 KB
scripts/number-grammar.mjsscript2.1 KB
scripts/number-grammar.test.tsscript1.8 KB
scripts/numerals.mjsscript12.0 KB
scripts/numerals.test.tsscript6.1 KB
scripts/outcome-start.mjsscript3.8 KB
scripts/outcome-start.test.tsscript5.0 KB
scripts/outcome.mjsscript10.5 KB
scripts/outcome.test.tsscript12.8 KB
scripts/page-source-locator.test.tsscript11.7 KB
scripts/particles-ko.mjsscript4.8 KB
scripts/particles-ko.test.tsscript4.3 KB
scripts/placeholder.mjsscript9.3 KB
scripts/placeholder.test.tsscript3.8 KB
scripts/polish-apply.mjsscript6.8 KB
scripts/polish-apply.test.tsscript19.7 KB
scripts/polish-diff.mjsscript1.7 KB
scripts/polish-diff.test.tsscript10.1 KB
scripts/polish-markup.test.tsscript14.0 KB
scripts/polish-partial.test.tsscript2.5 KB
scripts/polish-project.mjsscript5.8 KB
scripts/polish-rules.mjsscript9.8 KB
scripts/rational.mjsscript5.2 KB
scripts/rational.test.tsscript1.9 KB
scripts/raw-decode.mjsscript4.5 KB
scripts/raw-locator.mjsscript2.4 KB
scripts/raw-snapshot.test.tsscript7.3 KB
scripts/references-fences.test.tsscript1.2 KB
scripts/repair-tracker.mjsscript7.5 KB
scripts/repair-tracker.test.tsscript10.8 KB
scripts/report-tools-2.test.tsscript16.1 KB
scripts/report-tools-3.test.tsscript9.3 KB
scripts/report-tools-4.test.tsscript10.1 KB
scripts/report-tools-5.test.tsscript14.6 KB
scripts/report-tools-commands.mjsscript12.9 KB
scripts/report-tools.mjsscript2.6 KB
scripts/report-tools.test.tsscript12.1 KB
scripts/sentence-split.mjsscript3.0 KB
scripts/sentence-split.test.tsscript4.5 KB
scripts/snapshot-readability.test.tsscript7.0 KB
scripts/source-commands.mjsscript12.4 KB
scripts/source-integrity.test.tsscript18.1 KB
scripts/source-refresh.mjsscript5.2 KB
scripts/source-snapshot.mjsscript9.9 KB
scripts/source-snapshot.test.tsscript6.3 KB
scripts/source-view.mjsscript5.0 KB
scripts/sources-citation.mjsscript12.1 KB
scripts/sources-citation.test.tsscript14.8 KB
scripts/tests/contracts-support.tsscript3.5 KB
scripts/tests/delivery-barrier-session.tsscript3.3 KB
scripts/tests/derive-clock.tsscript341 B
scripts/tests/fact-derive-support.tsscript1.9 KB
scripts/tests/fact-unit-dimensions-support.tsscript1.5 KB
scripts/tests/fact-unit-rules-support.tsscript16.8 KB
scripts/tests/fidelity-values-support.tsscript1.6 KB
scripts/tests/fixtures/assets/figure-1.svgother141 B
scripts/tests/fixtures/bad-report.htmlother2.1 KB
scripts/tests/fixtures/boxes.jsonconfig3.2 KB
scripts/tests/fixtures/conversion-probe.htmlother485 B
scripts/tests/fixtures/design-spec.mdmarkdown458 B
scripts/tests/fixtures/fidelity-brief-locked.mdmarkdown571 B
scripts/tests/fixtures/fidelity-brief-pending.mdmarkdown574 B
scripts/tests/fixtures/fidelity/assets/share.csvother40 B
scripts/tests/fixtures/fidelity/claim-graph.mdmarkdown449 B
scripts/tests/fixtures/fidelity/gen-legacy-dev.mjsscript5.0 KB
scripts/tests/fixtures/fidelity/ledger-basic.jsonconfig5.1 KB
scripts/tests/fixtures/fidelity/ledger-legacy-dev.jsonconfig18.3 KB
scripts/tests/fixtures/fidelity/ledger-verify.jsonconfig9.1 KB
scripts/tests/fixtures/fidelity/polish-edits.jsonconfig303 B
scripts/tests/fixtures/fidelity/report-bad.htmlother821 B
scripts/tests/fixtures/fidelity/report-good.htmlother2.4 KB
scripts/tests/fixtures/fidelity/sources/S4.htmlother680 B
scripts/tests/fixtures/fidelity/sources/S4/acronyms.jsonconfig36 B
scripts/tests/fixtures/fidelity/sources/S4/meta.jsonconfig256 B
scripts/tests/fixtures/fidelity/sources/S4/sentences.jsonlother623 B
scripts/tests/fixtures/fidelity/sources/S4/text.txtmarkdown300 B
scripts/tests/fixtures/fidelity/sources/S5/acronyms.jsonconfig3 B
scripts/tests/fixtures/fidelity/sources/S5/meta.jsonconfig235 B
scripts/tests/fixtures/fidelity/sources/S5/sentences.jsonlother53 B
scripts/tests/fixtures/fidelity/sources/S5/text.txtmarkdown10 B
scripts/tests/fixtures/fidelity/sources/S9.txtmarkdown128 B
scripts/tests/fixtures/good-report.htmlother2.7 KB
scripts/tests/fixtures/reference-report.htmlother2.5 KB

scripts/fidelity-lexicon.mjs

View on GitHub
// fidelity-lexicon.mjs - closed-list lexical checks over (source quote, report sentence) pairs.
//
// lexiconChecks compares each pair with the lexicon.mjs lists: hedge_dropped, direction_flipped,
// causality_added, qualifier_dropped (six-token window around the fact span; a :q rendering puts
// the qualifier inside the span), scope_widened_warn, and the acronym-aware name_outside_quote.
// The hedge-position heuristic never yields a code; it only sets force_strong for the meaning
// verifier; name_outside_quote and scope_widened_warn also emit minor defects. Latin terms match whole words (terms
// of four or more letters also match their inflections); Korean terms match as substrings, single
// syllables as tokens. No model, no IO. Plain Node ESM; Korean strings are \u escapes.

import { CAUSAL, CONCESSIVE, DIRECTION, HEDGES, NEGATION, QUALIFIERS, SCOPE_NARROW_TO_BROAD } from "./lexicon.mjs"
import { normalizeText } from "./text-normalize.mjs"
import { normalizeUnit } from "./units.mjs"

/** Ledger qualifier terms -> their surface forms in either language (closed mapping). */
export const QUALIFIER_FORMS = Object.freeze({
  upper_inclusive: ["up to", "at most", "\uCD5C\uB300", "\uC774\uD558", "\uAE4C\uC9C0"],
  lower_inclusive: ["at least", "\uCD5C\uC18C", "\uC774\uC0C1"],
  approximate: ["about", "approximately", "\uC57D", "\uB0B4\uC678"],
  near: ["nearly"],
  lower_exclusive: ["over", "more than", "\uCD08\uACFC"],
  upper_exclusive: ["under", "less than", "\uBBF8\uB9CC"],
})
/** Irregular and synonym direction forms the stem match cannot reach ("rose", "reduced"). */
const DIRECTION_FORMS = {
  up: ["rose", "risen", "rising", "grew", "grown", "gain"],
  down: ["reduc", "fell", "fallen", "falling", "drop", "lower"],
}
const KOREAN = /[\uAC00-\uD7A3]/
/** True when the term holds a Hangul syllable (Korean terms match by the Korean rules below). */
export const isKoreanTerm = (term) => KOREAN.test(term)
/** The guarded hedge and qualifier vocabulary: the union of HEDGES, QUALIFIERS and every QUALIFIER_FORMS surface form. */
export const guardedTerms = () => [...new Set([...HEDGES, ...QUALIFIERS, ...Object.values(QUALIFIER_FORMS).flat()])]
const ACRONYM = /(?<![\p{L}\p{N}])[A-Z]{2,6}(?![\p{L}\p{N}])/gu
const WINDOW = 6
const cache = new Map()

const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")

/**
 * The lexical pattern engine. mode: "stem" (inflections, Korean one-syllable token prefix), "exact",
 * "word", "suffix" (Korean attached to a value), "guard" (single Latin words of four or more letters
 * take inflections, multiword terms never do; Korean terms match as plain substrings).
 */
export function lexicalPattern(term, mode) {
  const key = `${mode}\u0001${term}`
  if (cache.has(key)) return cache.get(key)
  let source
  if (!KOREAN.test(term)) {
    const stems = term.length >= 4 && (mode === "stem" || (mode === "guard" && !term.includes(" ")))
    source = `(?<![\\p{L}\\p{N}])${escape(term).replace(/ /g, "\\s+")}${stems ? "\\p{L}*" : ""}(?![\\p{L}\\p{N}])`
  } else if (mode === "guard") source = escape(term)
  else if (mode === "suffix") source = `(?<=^|[\\s\\p{P}\\p{N}A-Za-z])${escape(term)}(?=$|[\\s\\p{P}])`
  else if ([...term].length >= 2 || mode === "word") source = escape(term)
  else source = `(?<=^|[\\s\\p{P}])${escape(term)}${mode === "stem" ? "" : "(?=$|[\\s\\p{P}])"}`
  const re = new RegExp(source, "giu")
  cache.set(key, re)
  return re
}

function positions(text, terms, mode) {
  const out = []
  for (const term of terms)
    for (const match of text.matchAll(lexicalPattern(term, mode))) out.push({ term, at: match.index })
  return out.sort((a, b) => a.at - b.at)
}

const has = (text, terms, mode) => positions(text, terms, mode).length > 0
const tokens = (text) => text.split(/\s+/).filter(Boolean)
const stripQualifiers = (text) =>
  QUALIFIERS.reduce((rest, term) => rest.replace(lexicalPattern(term, "exact"), " "), text)

function directions(text) {
  const rest = stripQualifiers(text)
  return {
    up: has(rest, DIRECTION.up, "stem") || has(rest, DIRECTION_FORMS.up, "stem"),
    down: has(rest, DIRECTION.down, "stem") || has(rest, DIRECTION_FORMS.down, "stem"),
  }
}

/** The fact span plus up to six tokens on each side, never crossing the sentence. */
function qualifierWindow(sentence, span) {
  const [start, end] = span
  return [
    ...tokens(sentence.slice(0, start)).slice(-WINDOW),
    sentence.slice(start, end),
    ...tokens(sentence.slice(end)).slice(0, WINDOW),
  ].join(" ")
}

function qualifierDropped(pair) {
  if (!pair.qualifier || !Array.isArray(pair.span)) return false
  const forms = QUALIFIER_FORMS[pair.qualifier] ?? [pair.qualifier]
  const window = qualifierWindow(pair.sentence, pair.span)
  return !forms.some((form) => has(window, [form], KOREAN.test(form) ? "suffix" : "exact"))
}

/** A hedge before the sentence's last concessive while the quote hedges its own final clause. */
function hedgeMoved(quote, sentence) {
  const lastConcessive = (text) => positions(text, CONCESSIVE, "word").at(-1)?.at ?? -1
  const sentenceHedge = positions(sentence, HEDGES, "stem")[0]?.at
  const quoteHedge = positions(quote, HEDGES, "stem").at(-1)?.at
  const sentenceConcessive = lastConcessive(sentence)
  return (
    sentenceHedge !== undefined &&
    quoteHedge !== undefined &&
    sentenceHedge < sentenceConcessive &&
    quoteHedge > lastConcessive(quote)
  )
}

function pairFindings(pair) {
  const quote = normalizeText(pair.quote)
  const sentence = normalizeText(pair.sentence)
  const found = []
  const add = (code, message) => found.push({ pair_id: pair.pair_id, code, message })
  const dropped = qualifierDropped(pair)
  if (dropped) add("qualifier_dropped", `the source bounds the value (${pair.qualifier}) and the sentence drops it`)
  const sourceHedges = positions(quote, HEDGES, "stem")
  const qualifierOnly = sourceHedges.every(({ term }) => QUALIFIERS.includes(term))
  if (sourceHedges.length > 0 && !has(sentence, HEDGES, "stem") && !(dropped && qualifierOnly)) {
    add("hedge_dropped", `the source hedges ("${sourceHedges[0].term}") and the sentence does not`)
  }
  const [from, to] = [directions(quote), directions(sentence)]
  const negated = has(quote, NEGATION, "word") || has(sentence, NEGATION, "word")
  if (!negated && ((from.up && !from.down && to.down && !to.up) || (from.down && !from.up && to.up && !to.down))) {
    add(
      "direction_flipped",
      `the source says ${from.up ? "up" : "down"} and the sentence says ${to.up ? "up" : "down"}`,
    )
  }
  const causal = positions(sentence, CAUSAL, "word").find(({ term }) => !has(quote, [term], "word"))
  if (causal) add("causality_added", `"${causal.term}" states a cause the source does not`)
  const context = [quote, ...(pair.context ?? []).map(normalizeText)]
  for (const [narrow, broad] of SCOPE_NARROW_TO_BROAD) {
    if (
      has(quote, [narrow], "word") &&
      has(sentence, [broad], "word") &&
      !context.some((text) => has(text, [broad], "word"))
    ) {
      add("scope_widened_warn", `the source says "${narrow}" and the sentence says "${broad}"`)
    }
  }
  const acronyms = pair.acronyms ?? {}
  const quoteNames = new Set(quote.match(ACRONYM) ?? [])
  const stray = (sentence.match(ACRONYM) ?? []).find(
    (name) => !quoteNames.has(name) && !Object.hasOwn(acronyms, name) && !normalizeUnit(name),
  )
  if (stray) add("name_outside_quote", `"${stray}" is in neither the quote nor the source's acronym table`)
  return found
}

/**
 * @param {{ pair_id: string, quote: string, sentence: string, span?: [number, number] | null,
 *   qualifier?: string | null, acronyms?: Record<string, string>, context?: string[] }[]} pairs
 * @returns {{ findings: { pair_id: string, code: string, message: string }[], forceStrong: string[] }}
 */
export function lexiconChecks(pairs) {
  const findings = []
  const forceStrong = []
  for (const pair of pairs) {
    const found = pairFindings(pair)
    findings.push(...found)
    const routed = found.some(({ code }) => code === "name_outside_quote" || code === "scope_widened_warn")
    if (routed || hedgeMoved(normalizeText(pair.quote), normalizeText(pair.sentence))) forceStrong.push(pair.pair_id)
  }
  return { findings, forceStrong }
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall