statute-compare
Compare statutory provisions on the same topic across two or more jurisdictions. Invoke when the user asks "regulation / comparison / difference / similarities and differences of X in A/B/C jurisdictions". Covers five dimensions: scope of application, elements, exceptions, penalties, effective date.
- License 许可
- CC-BY-4.0
- 所属仓库
- KairosPan/kairos
- 最近更新
- 2026-07-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- a2a
- { "expose": true, "billing": { "model": "free" }, "endpoint_path": "/a2a/skills/statute-compare" }
- name
- statute-compare
- inputs
- { "$ref": "./schemas/inputs.json" }
- limits
- { "max_tokens": 16000, "timeout_action": "partial-result", "max_latency_seconds": 60 }
- models
- { "cheap": "deepseek-v4-flash", "fallback": "claude-opus-4-7", "forbidden": [], "preferred": "claude-opus-4-7" }
- safety
- { "upl_check": "not-applicable", "disclaimer": "legal-research-only", "matter_scope": "enforced", "citation_verification": "required", "jurisdiction_consistency": "required" }
- billing
- { "model": "free" }
- license
- CC-BY-4.0
- outputs
- { "$ref": "./schemas/outputs.json" }
- version
- 0.1.0
- eval_set
- ./evals/statute-compare-v1.jsonl
- triggers
- { "keywords": [ "compare statutes", "statute comparison", "regulatory comparison", "cross-jurisdiction comparison", "regulation difference" ], "do_not_fire_when": [ "the user has named only one jurisdiction (a comparison needs two or more)", "the request is about a single statute's meaning rather than a cross-jurisdiction comparison", "the relevant statutory topic or provisions have not been identified" ] }
- languages
- [ "en", "zh" ]
- optimizer
- { "L2_rag": "enabled", "L4_model": "shadow", "L1_prompt": "enabled", "L3_routing": "enabled", "L6_self_mod": "disabled", "L5_synthesis": "disabled" }
- retrieval
- { "fusion": "rrf", "layers": [ "structural", "lexical", "semantic", "citation_graph", "rerank", "mmr" ], "rerank": { "cloud": null, "local": "bge-reranker-v2-m3" }, "embedding": { "cloud": null, "local": "bge-large-v1.5", "cloud_allowed_corpus": [ "public" ] }, "mmr_lambda": 0.5, "matter_isolation": "required", "citation_required": true }
- risk_tier
- low
- maintainer
- kairos-core
- risk_class
- medium
- visibility
- public
- description
- Compare statutory provisions on the same topic across two or more jurisdictions. Invoke when the user asks "regulation / comparison / difference / similarities and differences of X in A/B/C jurisdictions". Covers five dimensions: scope of application, elements, exceptions, penalties, effective date.
- display_name
- Cross-Jurisdiction Statute Comparison
- golden_cases
- []
- strict_model
- false
- target_users
- [ "lawyer", "researcher", "student" ]
- default_model
- claude-opus-4-7
- jurisdictions
- [ "agnostic" ]
- allowed_models
- [ "claude-opus-4-7", "deepseek-v4-pro", "deepseek-v4-flash" ]
- practice_areas
- [ "regulatory", "privacy", "ai-governance" ]
- required_skills
- [ "kairos/query-parser", "kairos/retrieval-hybrid", "kairos/citation-verify", "kairos/disclaimer-injector" ]
- requires_skills
- []
- setup_interview
- { "required": false, "questions": [ "What is your primary practice jurisdiction? (used for default sorting)", "Your usual citation format? (Bluebook / SAC / OSCOLA / GB/T 7714)", "Default depth of comparison: brief / medium / deep (with legislative history + doctrine)", "Output language preference: English / Chinese / Bilingual" ] }
- requires_sandbox
- false
- side_effect_class
- pure_read
- optional_connectors
- [ "kairos/legal-data-hunter", "kairos/hk-statutes" ]
- required_connectors
- [ "kairos/free-law-project", "kairos/descrybe", "kairos/cn-statutes", "kairos/eu-legislation" ]
- requires_connectors
- { "any": [ "cn-statutes", "eu-legislation" ] }
02 资源文件 11
- 参考文档evals/golden_cases/gc-statute-compare-001.yaml448 B
- 参考文档evals/golden_cases/gc-statute-compare-002.yaml461 B
- 参考文档evals/golden_cases/gc-statute-compare-003.yaml492 B
- 其他evals/statute-compare-v1.jsonl2.0 KB
- 参考文档prompts/align.md1021 B
- 参考文档prompts/plan.md771 B
- 参考文档prompts/synthesize.md1.4 KB
- 参考文档prompts/system.md1.5 KB
- 参考文档schemas/inputs.json1.1 KB
- 参考文档schemas/outputs.json1.6 KB
- 其他templates/comparison-table.md.j2744 B
03 SKILL.md 正文
Statute Compare
When to use
Cross-jurisdiction comparison of statutory provisions on the same topic. Typical queries:
- "Comparison of data localization requirements in CN / EU / IN"
- "Differences between US and China on non-compete provisions"
- "Comparison of GDPR Art. 22 and CCPA §1798.105 on automated decision-making"
Workflow (one-to-one with workflow runtime steps)
- Parse — invoke
kairos/query-parserto extract{ topic, jurisdictions[], depth, output_lang } - Retrieve — invoke
kairos/retrieval-hybridfor each jurisdiction (per-jurisdiction parallel) - Extract elements — extract the 5-tuple "scope of application / elements / exceptions / penalties / effective date" from each candidate provision
- Align — cross-jurisdiction alignment (synonymous term mapping + concept alignment; see prompts/align.md)
- Generate — render structured comparison using templates/comparison-table.md.j2
- Verify — invoke
kairos/citation-verify: trace every citation back to the connector source, eliminate hallucinations - Inject — invoke
kairos/disclaimer-injectorto enforce disclaimer
Output contract (see schemas/outputs.json)
summary: string(natural-language summary)comparison_table: List[ComparisonRow], each row{ topic, jurisdiction, scope, elements, exceptions, penalties, effective_date, citation, coverage }citations: List[Citation]— must be non-empty, enforced by Safety Gatejurisdiction_consistency_note: string(warning about common-law/civil-law mixing, if any)disclaimer: string
Known failure modes
- When a jurisdiction has no corresponding provision → must explicitly
coverage: "no matching provision"; no fabrication - Chinese-English term alignment is error-prone → prompts/align.md mandates an alignment sub-step
- Old laws are repealed → connector must return
amendment_status; prompt must use the latest in-force version
Evaluation dimensions (aligned with §5.3)
citation_accuracy≥ 0.95jurisdiction_consistency= passcoverage_completeness≥ 0.95disclaimer_present= pass
04 同仓库更多 Skills
setup-interview
On first install/subscription of a skill, run a guided interview to learn the lawyer's playbook (jurisdiction / citation style / risk tolerance / output preferences) and write the answers to user/firm preferences. Mirrors the Anthropic plugin setup-interview UX. Feeds the §5 self-improving feedback source.
retrieval-hybrid
Run the §7.4 hybrid pipeline (structural filter → BM25/FTS5 → local semantic → citation graph → RRF fusion → local rerank → MMR) for one query, returning ranked candidates with full source provenance. Invoke whenever a skill needs to fetch passages from any matter (private or public) before drafting.
query-parser
Extract structured legal-research facets (jurisdiction, doc_type, citation_id, date_range, practice_area, matter_id) from a natural-language query. Invoked first by every retrieval-bearing skill (statute-compare, case-retrieve, ...).
document-intake
Advisory guidance on getting a document into a matter's private index: which file formats are supported, how confidentiality levels behave (privileged documents are stored but never FTS-indexed, per database-design §3.2), and where to upload. The actual ingestion + extraction + indexing is performed by the conversation file-upload route, NOT by this skill — this skill only explains the path.
disclaimer-injector
Inject the appropriate legal disclaimer (legal-research-only, in-house-counsel-only, or academic-use) into the trailing `disclaimer` field of a draft response. Mandatorily run by the Safety Gate; skill authors should not invoke directly.
contract-risk-annotate
Take an extracted clause list and annotate each clause with jurisdiction-aware risks (governing law mismatch, unenforceable non-compete under target jurisdiction, missing carve-outs, one-sided indemnification, etc.). Invoked after contract-clause-extract; uses statute-compare under the hood when the user asks for cross-jurisdiction risk.