135 lines
3.3 KiB
Markdown
135 lines
3.3 KiB
Markdown
# Skills-Vault Request: Review Bundle Audit
|
|
|
|
Date: 2026-06-19
|
|
|
|
Requested supplier repository:
|
|
|
|
```text
|
|
C:\Users\wangq\Documents\Codex\skills-vault
|
|
```
|
|
|
|
Requesting CCPE artifacts:
|
|
|
|
```text
|
|
agents/agent-specs/ccra-local-reviewer.agent.md
|
|
runtimes/hybrid/ccra-local-review.runtime.md
|
|
```
|
|
|
|
## 1. Capability Name
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
bundle_root: path to a review bundle directory
|
|
profile: optional bundle profile name
|
|
```
|
|
|
|
For The Mindscape of Bro Tsong, the relevant path pattern is:
|
|
|
|
```text
|
|
ccra_review_bundle/<round-or-pass>/
|
|
```
|
|
|
|
## 5. Expected Outputs
|
|
|
|
Write or return a deterministic audit report with:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
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.
|