3.3 KiB

Raw Blame History

Skills-Vault Request: Review Bundle Audit

Date: 2026-06-19

Requested supplier repository:

C:\Users\wangq\Documents\Codex\skills-vault

Requesting CCPE artifacts:

agents/agent-specs/ccra-local-reviewer.agent.md
runtimes/hybrid/ccra-local-review.runtime.md

1. Capability Name

review-bundle-audit

2. Product / Runtime Context

Local CCRA review needs a deterministic preflight check for review bundles before the ccra-local-reviewer Agent spends judgment budget.

The first consumer is:

C:\Users\wangq\Documents\Codex\work-projects\the-mindscape-of-bro-tsong

The operation should be reusable for other projects that package files for local or Web reviewer handoff.

3. Repeated Action Or Friction Point

Review bundles may be missing briefs, manifests, validation sidecars, reports, raw zip files, or changed-file summaries. Human and Agent review quality drops when the bundle structure is incomplete or when the reviewer must discover the file set manually.

4. Inputs

Expected input:

bundle_root: path to a review bundle directory
profile: optional bundle profile name

For The Mindscape of Bro Tsong, the relevant path pattern is:

ccra_review_bundle/<round-or-pass>/

5. Expected Outputs

Write or return a deterministic audit report with:

bundle_root
files_discovered
required_files_present
required_files_missing
optional_files_present
manifest_status
zip_status
validation_sidecar_status
report_status
warnings
blocking_errors
machine_readable_summary

Preferred output files when called by a runtime:

bundle-audit.md
bundle-audit.json

6. Allowed Actions

Read the specified bundle directory.
Inspect filenames, relative paths, manifest contents, and sidecar JSON/Markdown files.
Validate zip readability when a zip is present.
Write audit outputs only to the caller-specified review run directory.

7. Forbidden Actions

Do not modify review bundle source files.
Do not create or repair bundles.
Do not edit model cards, selector rules, regression cases, or project docs.
Do not decide whether a review is accepted.

8. Validation Expectation

The Skill should include tests for:

complete bundle
missing required brief
missing manifest
missing validation sidecar
unreadable zip
extra files that should be warnings, not blockers
UTF-8 paths and Chinese filenames

9. Reusability Rationale

This is a deterministic file/package audit, not a CCRA judgment. It belongs in skills-vault and should be named by the reusable operation rather than by one project-specific review context.

Example non-CCRA consumers:

writing-workbench:
  Check article review packages before sending them to outline, structure, or style reviewers.

video-workbench:
  Check script / storyboard / asset handoff packages before production review.

skills-vault:
  Check Skill release packages before installation or publishing.

ccpe-system:
  Check Agent, Runtime, Skill, or review-committee handoff packages before formal participant invocation.

development repositories:
  Check release review bundles that contain diffs, test logs, deployment notes, and rollback plans.

10. Current Blocked Task

ccra-local-reviewer can manually inspect bundles, but official Local CCRA Runtime automation should call this Skill once it exists and is registered.

3.3 KiB Raw Blame History