HK IPO Review Optimizer
Use this skill for the post-decision feedback loop.
Runtime
This publish bundle includes the required CLI runtime under runtime/hkipo-next.
From the skill folder:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next ...
By default review history is stored in ~/.hkipo-next/data/hkipo.db.
Workflow
- Use
review listto find target records. - Use
review showbefore updating a record. - Use
review updateto add actual results and variance notes. - Use
review exportwhen another tool needs a JSON dataset. - Use
apply-suggestions showbefore accepting or rejecting imported suggestions.
Commands
List recent review records:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next review list --limit 20 --format json
Show a record:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next review show rvw_123 --format json
Update actual results:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next review update rvw_123 \
--allocated-lots 2 \
--listing-return-pct 14.2 \
--exit-return-pct 9.8 \
--realized-pnl-hkd 1860 \
--notes "Sold into first-day strength" \
--variance-note "Grey market was weaker than expected but sponsor demand held" \
--format json
Export a review dataset:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next review export --from 2026-04-01 --to 2026-04-16 --output /tmp/hkipo-review.json --format text
Preview and accept a suggestion:
cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next apply-suggestions show sgg_123 --format json
uv run --directory runtime/hkipo-next hkipo-next apply-suggestions accept sgg_123 --reason "Matches observed listing-day slippage" --format json
Output Cues
- Review records preserve the original prediction payload, data status, and source issue count.
- Suggestion detail output shows whether a proposed change would create a new parameter version.
Companion Skills
- Use
$hkipo-parameter-managerwhen a review conclusion needs manual tuning work. - Use
$hkipo-decision-engineto rerun fresh decisions after a rule change.
