AGENT SKILL

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

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)

  1. Parse — invoke kairos/query-parser to extract { topic, jurisdictions[], depth, output_lang }
  2. Retrieve — invoke kairos/retrieval-hybrid for each jurisdiction (per-jurisdiction parallel)
  3. Extract elements — extract the 5-tuple "scope of application / elements / exceptions / penalties / effective date" from each candidate provision
  4. Align — cross-jurisdiction alignment (synonymous term mapping + concept alignment; see prompts/align.md)
  5. Generate — render structured comparison using templates/comparison-table.md.j2
  6. Verify — invoke kairos/citation-verify: trace every citation back to the connector source, eliminate hallucinations
  7. Inject — invoke kairos/disclaimer-injector to 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 Gate
  • jurisdiction_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.95
  • jurisdiction_consistency = pass
  • coverage_completeness ≥ 0.95
  • disclaimer_present = pass

04 同仓库更多 Skills

KairosPan
KairosPan/kairos

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.

★ 0
KairosPan
KairosPan/kairos

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.

★ 0
KairosPan
KairosPan/kairos

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, ...).

★ 0
KairosPan
KairosPan/kairos

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.

★ 0
KairosPan
KairosPan/kairos

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.

★ 0
KairosPan
KairosPan/kairos

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.

★ 0