frostbyte_neo/yao-meta-skill
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

docs: document clean-lock report refresh

Browse Source
This commit is contained in:
yaojingang
2026-06-14 12:52:36 +08:00
parent ec9474d0a6
commit 38c5785ff3
2 changed files with 21 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+13
View File
@@ -47,10 +47,23 @@ python3 scripts/render_world_class_evidence_intake.py . --generated-at "$GENERAT
python3 scripts/render_world_class_submission_review.py . --generated-at "$GENERATED_AT"
python3 scripts/render_world_class_operator_runbook.py . --generated-at "$GENERATED_AT"
python3 scripts/render_world_class_claim_guard.py . --generated-at "$GENERATED_AT"
python3 scripts/render_skill_os2_coverage.py . --generated-at "$GENERATED_AT"
python3 scripts/render_skill_overview.py .
python3 scripts/render_review_viewer.py .
python3 scripts/render_review_studio.py . --output-html reports/review-studio.html --output-json reports/review-studio.json
```
For final release evidence, commit source and generated package evidence first, then run the clean-lock reports from a clean worktree:
```bash
python3 scripts/render_benchmark_reproducibility.py . --generated-at "$GENERATED_AT"
python3 scripts/render_skill_overview.py .
python3 scripts/render_review_viewer.py .
python3 scripts/render_review_studio.py . --output-html reports/review-studio.html --output-json reports/review-studio.json
```
If `reports/benchmark_reproducibility.json` reports `release_lock_ready: false`, do not commit that benchmark as release evidence. Restore the transient dirty-lock reports, commit the source/generated evidence that caused the dirty state, and regenerate the clean-lock reports on the resulting clean tree.
Local sync into `~/.agents/skills.disabled/yao-meta-skill` or `~/.agents/skills/yao-meta-skill` must keep the install preflight enabled unless the user explicitly requests a diagnostic bypass. `make sync-local-install` and `make sync-active-install` rebuild the package first, then `scripts/sync_local_install.py` refuses to copy files when install simulation or installer permission enforcement fails.
Clean test-only scratch directories after verification with `find tests -maxdepth 1 \( -name 'tmp' -o -name 'tmp_*' \) -type d -exec rm -rf {} +`. Do not clean unrelated untracked files.
tests/verify_review_viewer.py
+8
View File
@@ -11,11 +11,19 @@ ROOT = Path(__file__).resolve().parent.parent
def assert_root_world_class_commands_are_current() -> None:
root_json = ROOT / "reports" / "review-viewer.json"
root_html = ROOT / "reports" / "review-viewer.html"
agent_docs = (ROOT / "AGENTS.md").read_text(encoding="utf-8")
assert root_json.exists(), root_json
assert root_html.exists(), root_html
json_text = root_json.read_text(encoding="utf-8")
assert 'python3 scripts/yao.py world-class-intake ."' not in json_text, root_json
assert "world-class-intake . --submissions-dir evidence/world_class/submissions" in json_text, root_json
for fragment in (
'python3 scripts/render_skill_os2_coverage.py . --generated-at "$GENERATED_AT"',
'python3 scripts/render_benchmark_reproducibility.py . --generated-at "$GENERATED_AT"',
"python3 scripts/render_review_viewer.py .",
"release_lock_ready: false",
):
assert fragment in agent_docs, fragment
def main() -> None: