foryourhealth111-pixel/Vibe-Skills
vibe
VerifiedVibe Code Orchestrator (VCO) is a governed runtime entry that freezes requirements, bounds execution, and enforces verification and phase cleanup.
scripts/common/README.md
View on GitHub# Common Script Primitives
- Scripts root: [`../README.md`](../README.md)
- Verify surface: [`../verify/README.md`](../verify/README.md)
- Governance surface: [`../governance/README.md`](../governance/README.md)
## What Lives Here
`scripts/common/` 保存被多个 governance / verify 脚本复用的共享原语,避免各脚本重复实现 BOM 检查、路径归一化、execution-context 校验与 wave gate harness。
## Stable API
### Text / BOM
- `New-VgoUtf8NoBomEncoding`
- `Write-VgoUtf8NoBomText`
- `Append-VgoUtf8NoBomText`
- `Test-VgoUtf8BomBytes`
- `Get-VgoFileBomInfo`
### Path / Repo Context
- `ConvertTo-VgoFullPath`
- `Test-VgoPathWithin`
- `Resolve-VgoRepoRoot`
- `Get-VgoRelativePathPortable`
- `Get-VgoGovernanceContext`
- `Assert-VgoCanonicalExecutionContext`
### Parity / Packaging / Records
- `Remove-VgoIgnoredKeys`
- `Get-VgoNormalizedJsonHash`
- `Test-VgoFileParity`
- `Get-VgoRelativeFileList`
- `Get-VgoLatestJsonlRecord`
- `Get-VgoPackagingContract`
- `Get-VgoInstalledRuntimeConfig`
- `Get-VgoMirrorTopologyTargets`
- `Get-VgoMirrorTarget`
- `Get-VgoLegacySourceOfTruthCompatibility`
## Files
### [`vibe-governance-helpers.ps1`](vibe-governance-helpers.ps1)
Dot-sourced helper library for shared context resolution, no-BOM writing, parity checks, mirror topology lookup, and execution-context enforcement.
### [`vibe-wave-gate-runner.ps1`](vibe-wave-gate-runner.ps1)
Wave83-100 系列 gate 的共享 runner,负责:
- 读取 wave manifest
- 统一 assertion 输出
- 关键字 / 文件存在性检查
- 产出结构化 gate artifacts
## Rules
- 以 dot-source 方式复用 helper;不要把它当作独立 CLI 命令。
- 不要在单脚本里重复实现 no-BOM 写入或 canonical execution-context 逻辑;优先走这里的 stable API。
- 新增 common helper 后,必须更新本 README,并在调用方 README / docs 中补导航锚点。Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |