Skip to content

ccoalm/ccl-skills / skills/skill-extraction-workflow

skill-extraction-workflow

Flagged

复盘 / 沉淀 / 总结经验 / 补进技能 / 技能缺陷 / 流程优化 / would other teammates hit this / will we forget next time / teamwide recurrence / extract skill / post-mortem / 深度 review·审计技能仓库 / 对标外部技能包找 gap(benchmark superpowers·gstack 等) / 核查全局安装点(~/.config/opencode 等)旧快照是否遮蔽本仓技能 / 本仓(ccl-skills 等共享技能仓)OpenCode 项目配置·命令治理 → turn reusable lessons into durable CCL skills.

FileKindSize
SKILL.mdskill md111.0 KB
agents/openai.yamlconfig257 B
references/analysis-parse-fix-test-challenge-replay.mdmarkdown1.5 KB
references/attention-budget-ratchet.mdmarkdown13.7 KB
references/attribution-verification.mdmarkdown4.4 KB
references/bootstrap-slim-c3-obligation-table.mdmarkdown8.0 KB
references/correction-routing-map.mdmarkdown3.7 KB
references/coverage-exhaustion-traps.mdmarkdown19.6 KB
references/description-authoring.mdmarkdown21.1 KB
references/dual-track-review-gate.mdmarkdown110.6 KB
references/eval-routing.mdmarkdown22.2 KB
references/evidence-card-template.mdmarkdown3.2 KB
references/example-domain-preselect.mdmarkdown4.6 KB
references/external-practice-controls.mdmarkdown45.5 KB
references/extraction-lifecycle-handoff.mdmarkdown6.9 KB
references/extraction-quickstart.mdmarkdown20.2 KB
references/firing-point-placement.mdmarkdown21.3 KB
references/harness-patterns-and-eval.mdmarkdown42.6 KB
references/incident-postmortem-extraction.mdmarkdown28.8 KB
references/l0-l1-l2-routing.mdmarkdown10.3 KB
references/online-skill-review.mdmarkdown6.7 KB
references/parallel-stack-references-pattern.mdmarkdown35.9 KB
references/r0-leakage-audit.mdmarkdown19.9 KB
references/recurring-anti-patterns-checklist.mdmarkdown34.4 KB
references/resume-paused-delivery.mdmarkdown3.0 KB
references/review-feedback-mining.mdmarkdown5.7 KB
references/review-finding-standards.mdmarkdown7.3 KB
references/review-rubric.mdmarkdown3.1 KB
references/rule-consolidation.mdmarkdown38.2 KB
references/skill-listing-budget.mdmarkdown1.7 KB
references/source-register.mdmarkdown1.0 MB
references/source-to-skill-extraction.mdmarkdown109.3 KB
references/two-source-extraction-pattern.mdmarkdown19.4 KB
references/uiux-judgment-extraction.mdmarkdown19.1 KB
references/uiux-routing-map.mdmarkdown5.8 KB
references/validation-and-landing.mdmarkdown46.9 KB
scripts/AGENTS.mdmarkdown635 B
scripts/check-ccl-skills.shexecutablescript100.7 KB
scripts/check-contract-anchors.shexecutablescript5.6 KB
scripts/check-evidence-card-leak.shexecutablescript26.1 KB
scripts/check-mr-target-freshness.shexecutablescript9.4 KB
scripts/check-size-budget.shexecutablescript36.0 KB
scripts/check-sync-pointers.shexecutablescript22.6 KB
scripts/check_review_evidence_present.pyexecutablescript4.6 KB
scripts/contract-anchors.tsvother3.8 KB
scripts/entrypoint_form_census.pyexecutablescript7.1 KB
scripts/eval-golden-trace.rbexecutablescript10.0 KB
scripts/eval-health.rbexecutablescript14.6 KB
scripts/eval-routing-bank.rbexecutablescript30.4 KB
scripts/eval-routing.rbexecutablescript9.2 KB
scripts/extraction_review_gate.shexecutablescript1.8 KB
scripts/gate_receipt.pyexecutablescript24.7 KB
scripts/generic-r0-leak-scan.shexecutablescript12.4 KB
scripts/governing-chain-diff.pyexecutablescript12.8 KB
scripts/impact-chain-gate.rbexecutablescript124.4 KB
scripts/obligation-ledger.pyscript107.0 KB
scripts/reference-access-census.shexecutablescript8.3 KB
scripts/register-firing-path-resolution.rbexecutablescript48.4 KB
scripts/shared_git_surface_gate.pyexecutablescript38.0 KB
scripts/skill-behavior-eval.pyexecutablescript39.3 KB
scripts/skill-paired-eval.pyexecutablescript76.9 KB
scripts/source-register-lifecycle.rbscript1.5 KB
scripts/source-register-pending-status.rbscript2.0 KB
scripts/test_ai_coding_implementation_gates.shexecutablescript85.2 KB
scripts/test_antipattern_grep_panel.shexecutablescript3.2 KB
scripts/test_body_compliance_grading.shexecutablescript21.0 KB
scripts/test_check_ccl_impact_chain_refscripts.shexecutablescript145.1 KB
scripts/test_check_ccl_r0_status.shexecutablescript4.2 KB
scripts/test_check_ccl_register_pending_exclusion.shexecutablescript7.4 KB
scripts/test_check_ccl_regressions.shexecutablescript14.3 KB
scripts/test_check_ccl_route_drift.shexecutablescript22.6 KB
scripts/test_check_ccl_size_budget.shexecutablescript59.5 KB
scripts/test_check_ccl_skill_catalog.shexecutablescript23.3 KB
scripts/test_check_ccl_source_register_lifecycle.shexecutablescript6.1 KB
scripts/test_check_contract_anchors.shexecutablescript7.4 KB
scripts/test_check_mr_target_freshness.shexecutablescript12.8 KB
scripts/test_check_review_evidence_present.shexecutablescript4.3 KB
scripts/test_check_sync_pointers.shexecutablescript32.5 KB
scripts/test_ci_checkout_ref_binding.shexecutablescript8.2 KB
scripts/test_controlled_escalation_pins.shexecutablescript7.7 KB
scripts/test_entrypoint_domain_scan_terms.shexecutablescript8.8 KB
scripts/test_entrypoint_form_census.shexecutablescript6.3 KB
scripts/test_eval_routing_bank_grader_diagnostics.shexecutablescript20.6 KB
scripts/test_eval_routing_bank_resolution.shexecutablescript15.3 KB
scripts/test_eval_routing_bank_surface_binding.shexecutablescript6.9 KB
scripts/test_eval_routing_prose_target.shexecutablescript3.7 KB
scripts/test_eval_runtime.pyexecutablescript43.3 KB
scripts/test_extraction_review_gate.shexecutablescript15.2 KB
scripts/test_frozen_case_sanctity.shexecutablescript6.9 KB
scripts/test_frozen_case_sanctity_selfproof.shexecutablescript4.6 KB
scripts/test_gate_receipt.shexecutablescript17.7 KB
scripts/test_generic_r0_leak_scan.shexecutablescript6.4 KB
scripts/test_git_identity_predicate_gate.shscript13.8 KB
scripts/test_governing_chain_diff.shexecutablescript15.1 KB
scripts/test_impact_chain_gate_dateless_host.shexecutablescript6.8 KB
scripts/test_impact_chain_gate_verdict_differential.shexecutablescript20.8 KB
scripts/test_impact_chain_round_attribution.shexecutablescript32.5 KB
scripts/test_impact_chain_self_adjudication.shexecutablescript31.4 KB
scripts/test_impact_chain_source_refuted.shexecutablescript14.7 KB
scripts/test_liveness_predicate_gate.shexecutablescript14.5 KB
scripts/test_locale_independent_gates.shexecutablescript13.0 KB
scripts/test_obligation_ledger.shexecutablescript94.9 KB
scripts/test_obligation_ledger_repo_audit.shexecutablescript2.7 KB
scripts/test_pinned_phrase_mutation_walk.shexecutablescript6.5 KB
scripts/test_reference_access_census.shexecutablescript17.3 KB
scripts/test_register_firing_path_resolution.shexecutablescript41.0 KB
scripts/test_register_firing_path_wiring.shexecutablescript29.9 KB
scripts/test_regression_runner_lanes.shexecutablescript4.5 KB
scripts/test_regression_runner_registration.shexecutablescript1.5 KB
scripts/test_routing_bank_integrity.shexecutablescript15.5 KB
scripts/test_routing_pointer_integrity.shexecutablescript18.9 KB
scripts/test_shared_git_surface_gate.shexecutablescript76.8 KB
scripts/test_skill_paired_eval.pyscript60.0 KB
scripts/test_teardown_guard_pins.shexecutablescript17.0 KB
scripts/test_uiux_delivery_contract.shexecutablescript118.6 KB
scripts/test_uiux_loading_budget.shexecutablescript15.4 KB
scripts/test_validate_skill_credential_cwd.shexecutablescript2.6 KB
scripts/test_validate_skill_cross_refs.shexecutablescript4.8 KB
scripts/test_validate_skill_root_depth.shexecutablescript2.5 KB
scripts/validate-skill.shexecutablescript10.5 KB

scripts/test_ci_checkout_ref_binding.sh

View on GitHub
#!/usr/bin/env bash
# The gate lane must be judged on the BRANCH, not on the synthetic merge ref.
#
# WHY THIS TEST EXISTS. `impact-chain-gate.rb` partitions history into rounds by
# walking the branch's own first-parent chain. That flag is load-bearing and
# pinned by its own fixtures (`test_check_ccl_impact_chain_refscripts.sh`, round
# scoping 8): it is what collapses a merged worktree round to a single boundary
# when the ledger append precedes the owner work. Dropping it was tried and
# turned that fixture red.
#
# But the walk assumes the first-parent chain IS the branch's history. On the
# `refs/pull/N/merge` ref that actions/checkout uses by default for a
# pull_request event, HEAD is a merge whose first parent is the TARGET, so the
# walk finds only the merge commit and every round on the branch collapses into
# one. Rows whose validity depends on their round being narrow then flip red
# with nothing about them changed — observed on PR #53, where a description-only
# round lost its locator because a sibling round had edited the same owner's
# body. The two shapes are topologically identical (both are "merge X into Y
# where Y is the base"), so the gate cannot tell them apart from git alone; the
# harness has to hand it the right history instead.
#
# Hence: every job that runs a gate lane checks out the branch head. This test
# fails closed if a job loses that binding, because the symptom otherwise shows
# up as a confusing gate refusal on an unrelated PR months later.
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd -P)"
ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd -P)"
CI="$ROOT/.github/workflows/ci.yml"
[ -f "$CI" ] || { echo "FAIL: workflow not found: $CI" >&2; exit 1; }

fail() { echo "FAIL: $*" >&2; exit 1; }

# The jobs that run a lane consuming the impact-chain gate. Named explicitly
# rather than derived: a new gate-running job must be added here deliberately,
# and a job that stops running gates must be removed deliberately.
GATE_JOBS="repository-gates regression-fast regression-heavy code-review-regressions-1 code-review-regressions-2"

python3 - "$CI" $GATE_JOBS <<'PY'
import re, sys

path, jobs = sys.argv[1], sys.argv[2:]
src = open(path, encoding="utf8").read()

# PR text is mutable without a new commit. The metadata gate must rerun when a
# title or body edit is the only event, not only when the branch SHA changes.
trigger = re.search(r"^  pull_request:\s*\n((?: {4}.*\n)*)", src, re.M)
if trigger is None or not re.search(r"\bedited\b", trigger.group(1)):
    print(
        "FAIL: pull_request trigger does not include `edited`; PR text changes "
        "would bypass the shared Git/PR metadata gate",
        file=sys.stderr,
    )
    sys.exit(1)

# The shared metadata gate is also the backstop for authorized direct landing
# pushes. Both landing branches must trigger CI; the local hook is opt-in.
push_trigger = re.search(r"^  push:\s*\n((?: {4}.*\n)*)", src, re.M)
branches = set()
if push_trigger is not None:
    branch_row = re.search(r"branches:\s*\[([^]]*)\]", push_trigger.group(1))
    if branch_row is not None:
        branches = {item.strip() for item in branch_row.group(1).split(",") if item.strip()}
missing_push_branches = {"dev", "main"} - branches
if missing_push_branches:
    print(
        "FAIL: push trigger does not cover landing branch(es): "
        + ", ".join(sorted(missing_push_branches)),
        file=sys.stderr,
    )
    sys.exit(1)

# Split the jobs: mapping stanza at exactly two spaces of indent.
job_starts = [(m.start(), m.group(1)) for m in re.finditer(r"^  ([A-Za-z0-9_-]+):$", src, re.M)]
if not job_starts:
    print("FAIL: no jobs parsed out of the workflow", file=sys.stderr)
    sys.exit(1)
bounds = {}
for i, (pos, name) in enumerate(job_starts):
    end = job_starts[i + 1][0] if i + 1 < len(job_starts) else len(src)
    bounds[name] = src[pos:end]

failures = []
for job in jobs:
    body = bounds.get(job)
    if body is None:
        failures.append(f"{job}: job not present in the workflow (renamed? then update GATE_JOBS)")
        continue
    if "actions/checkout" not in body:
        failures.append(f"{job}: no checkout step")
        continue
    if "github.event.pull_request.head.sha" not in body:
        failures.append(
            f"{job}: checkout does not pin the branch head — it will run on the "
            f"refs/pull/N/merge ref, where the impact-chain gate's first-parent "
            f"round walk runs through the target and collapses every round into one"
        )
        continue
    # A fallback is required too: on `push` there is no pull_request context, and
    # an empty `ref:` silently checks out the default branch instead of failing.
    if "github.sha" not in body:
        failures.append(f"{job}: head-sha pin has no non-PR fallback (`|| github.sha`)")
        continue
    if "fetch-depth: 0" not in body:
        failures.append(f"{job}: no full history, so the gate cannot resolve its base")

repository_body = bounds.get("repository-gates", "")
step_start = re.search(
    r"^      - name:\s*Repository gate suite\s*$", repository_body, re.M
)
repository_step = ""
if step_start is None:
    failures.append(
        "repository-gates: `Repository gate suite` step is missing"
    )
else:
    next_step = re.search(r"^      - ", repository_body[step_start.end() :], re.M)
    step_end = (
        step_start.end() + next_step.start()
        if next_step is not None
        else len(repository_body)
    )
    repository_step = repository_body[step_start.start() : step_end]

if repository_step:
    if not re.search(
        r"^\s+CANDIDATE_BASE_REF:\s*\$\{\{\s*"
        r"github\.event\.pull_request\.base\.sha\s*\|\|\s*"
        r"github\.event\.before\s*\}\}\s*$",
        repository_step,
        re.M,
    ):
        failures.append(
            "repository-gates: `Repository gate suite` does not bind the PR "
            "base SHA with the pre-push event fallback; the commit range could "
            "collapse to HEAD and silently scan zero candidate commits"
        )
    if not re.search(
        r'^\s+if\s+\[\[\s+-n\s+"\$CANDIDATE_BASE_REF"\s+\]\]\s+&&\s+'
        r'git\s+merge-base\s+"\$CANDIDATE_BASE_REF"\s+HEAD\s+'
        r'>/dev/null\s+2>&1;\s+then\s*$\n'
        r'^\s+export\s+CCL_SKILL_BASE_REF="\$CANDIDATE_BASE_REF"\s*$\n'
        r'^\s+fi\s*$\n'
        r"^\s+make test-repo-gates\s*$",
        repository_step,
        re.M,
    ):
        failures.append(
            "repository-gates: `Repository gate suite` must validate the "
            "candidate base, export it, then invoke `make test-repo-gates` in "
            "that order; otherwise the metadata gate can scan the wrong range"
        )

if failures:
    for f in failures:
        print(f"FAIL: {f}", file=sys.stderr)
    sys.exit(1)
PY

default_make_dry_run="$(make --no-print-directory -n -C "$ROOT" test-repo-gates)"
override_make_dry_run="$(
  make --no-print-directory -n -C "$ROOT" \
    CCL_SKILL_DEFAULT_BASE_REF=refs/remotes/upstream/dev test-repo-gates
)"
python3 - "$default_make_dry_run" "$override_make_dry_run" <<'PY'
import shlex
import sys


def default_base(dry_run: str) -> str:
    commands = [
        line
        for line in dry_run.splitlines()
        if "shared_git_surface_gate.py" in line
    ]
    if len(commands) != 1:
        raise SystemExit(
            "FAIL: test-repo-gates must invoke the shared Git/PR metadata gate once"
        )
    tokens = shlex.split(commands[0])
    if tokens.count("--default-base-ref") != 1:
        raise SystemExit(
            "FAIL: test-repo-gates must pass exactly one --default-base-ref"
        )
    index = tokens.index("--default-base-ref")
    if index + 1 >= len(tokens):
        raise SystemExit("FAIL: --default-base-ref has no value")
    return tokens[index + 1]


default_value = default_base(sys.argv[1])
override_value = default_base(sys.argv[2])
if default_value != "origin/dev":
    raise SystemExit(
        f"FAIL: test-repo-gates compatibility default is {default_value!r}, "
        "expected 'origin/dev'"
    )
if override_value != "refs/remotes/upstream/dev":
    raise SystemExit(
        f"FAIL: caller default-base override resolved to {override_value!r}, "
        "expected 'refs/remotes/upstream/dev'"
    )
PY

echo "test_ci_checkout_ref_binding: ok (gate lanes judge the branch head, not the merge ref)"
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall