61 lines
2.5 KiB
Markdown
61 lines
2.5 KiB
Markdown
# VERIFY
|
|
|
|
Use this checklist when validating the `skill_lib` repository.
|
|
|
|
## Structural Checks
|
|
|
|
- All runtime packages live under `skill_lib/skills/`.
|
|
- Each skill package contains a `SKILL.md` or `SKILL.toml` plus a maintained `SKILL.md`.
|
|
- Each current skill package contains a `references/` directory.
|
|
- Each current skill package contains an `assets/` directory.
|
|
- Long operational detail lives in `references/`, not only in `SKILL.md`.
|
|
- Preserved remote source artifacts live in `assets/`.
|
|
- Browser extraction skills that promise structured output use `scripts/` when a deterministic script is required.
|
|
- Browser skills define blocked/login/captcha behavior explicitly instead of reporting only "no data".
|
|
- Downstream export/presentation skills consume upstream artifacts instead of recollecting browser data.
|
|
|
|
## Repository Scope Checks
|
|
|
|
- This repository does not contain Rust runtime dispatch code.
|
|
- This repository does not contain browser transport implementation code.
|
|
- This repository does not copy the original remote Rust modules into the skill packages.
|
|
- The repository is a skill description library, not a runtime executable.
|
|
|
|
## Package Inventory
|
|
|
|
Current packages:
|
|
|
|
- `zhihu-navigate`
|
|
- `zhihu-write`
|
|
- `zhihu-hotlist`
|
|
- `zhihu-hotlist-screen`
|
|
- `office-export-xlsx`
|
|
|
|
## Recommended Commands
|
|
|
|
```bash
|
|
find /home/zyl/projects/sgClaw/skill_lib/skills -mindepth 2 -maxdepth 2 -name SKILL.md | sort
|
|
find /home/zyl/projects/sgClaw/skill_lib/skills -type d \( -name references -o -name assets \) | sort
|
|
rg -n "^name: |^description: |^version: |^author: |^tags:" /home/zyl/projects/sgClaw/skill_lib/skills/*/SKILL.md
|
|
python3 /home/zyl/projects/sgClaw/claw/scripts/validate_skill_lib.py
|
|
```
|
|
|
|
From `/home/zyl/projects/sgClaw/claw`, run the project-local unit test suite:
|
|
|
|
```bash
|
|
python3 -m unittest tests.skill_lib_validation_test -v
|
|
python3 -m unittest tests.skill_script_hotlist_extractor_test -v
|
|
```
|
|
|
|
## Expected Outcome
|
|
|
|
- Exactly five active skill packages exist.
|
|
- Each package has both `references/` and `assets/`.
|
|
- Each maintained skill document exposes the standardized frontmatter keys used by this repository.
|
|
- The project-local validator reports `PASS` for all active packages.
|
|
- Browser-script packages pass their dedicated script-level regression tests.
|
|
|
|
## Known Caveat
|
|
|
|
- `skills/zhihu-hotlist/assets/zhihu_hotlist_flow.source.json` was reconstructed from an earlier successful source fetch because the remote endpoint timed out during the final implementation batch. Its content matches the previously captured remote flow used in analysis.
|