feat: add decision calibration, prediction tracking, and reference routing

SKILL.md
- Add triggers/mode to frontmatter for better skill routing
- Add mandatory JSON decision skeleton before every trade
- Add multi-source confirmation rule and common-mistakes guardrails
- Add prediction logging to hourly review workflow
- Restructure References into an explicit routing table

CLAUDE.md
- Add Reference routing table for agent context
- Fix remaining Hermes-only wording in gate description

references/user-data-layout.md
- Add complete log schema: decisions, trades, predictions, errors
- Document predictions_YYYYMMDD.jsonl for calibration feedback loop

README.md
- Mention prediction tracking in "Why it works"
- Update runtime directory layout to include predictions.jsonl

references/shim-templates.md
- Show platform cron config usage examples
This commit is contained in:
2026-04-16 03:03:25 +08:00
parent e75c54ca12
commit d1737cdcb8
5 changed files with 179 additions and 20 deletions

View File

@@ -36,7 +36,7 @@ The framework is designed to minimize LLM invocations:
1. A lightweight local Python precheck script decides whether market conditions have changed materially.
2. If `should_analyze=false`, the cron job emits `[SILENT]` and exits.
3. If `should_analyze=true`, the LLM performs deep analysis and may execute trades.
4. An optional external gate (system crontab) can run the precheck every 5 minutes and trigger the Hermes cron only on true events.
4. An optional external gate (system crontab) can run the precheck every 5 minutes and trigger the platform cron only on true events.
See `SKILL.md` (sections "Low-cost cron architecture" and "Building your own gate") for the full pseudocode, file layout, state schema, and troubleshooting.
@@ -98,6 +98,21 @@ When modifying or adding trading scripts, these safeguards from `SKILL.md` must
coinhunter probe bybit-ticker
```
## Reference routing
When working on Coin Hunter, read the relevant reference file at the right moment:
| Task context | File to read |
|--------------|--------------|
| Active trade decision (mainstream coin) | `references/short-term-trading-framework.md` |
| Active trade decision (meme coin) | `references/short-term-trading-framework.md` + `references/scam-signals.md` |
| Data source conflict / ambiguity | `references/provider-playbook.md` |
| Hourly review formatting | `references/review-template.md` |
| Runtime state / log schema questions | `references/user-data-layout.md` |
| Binance API / auto-trading setup | `references/auto-trading-guide.md` |
| Output format / report templates | `references/output-templates.md` |
| Proactive discovery scan workflow | `references/search-workflow.md` |
## When making changes
- If you change `SKILL.md`, check whether `README.md` needs corresponding updates.