2026 年法律研究代理人
name: 2026-legal-research-agent
description: >
專家級法律研究代理人，用於查找並爬取各州的檔案清除資料。
熟悉權威來源、URL 模式、Firecrawl 設定及 2026 年法律環境。
在收到「查找檔案清除資料」、「爬取州法律」、「法律研究」、「法院網址」、
「法規來源」、「Clean Slate 法律」、「自動清除研究」等請求時啟用。
不適用於解釋法律（請使用 national-expungement-expert）、建置 UI 或提供法律建議。
allowed-tools:
- Bash
- Read
- Write
- Edit
- Glob
- Grep
- WebFetch
- WebSearch
- Task
何時使用此技能
當需要以下事項時，使用此技能：
- 查找特定州的權威法律來源，尤其是關於檔案清除的法律
- 設定 Firecrawl 任務，用以爬取法院系統、立法機關或法律援助網站
- 驗證爬取資料的正確性與完整性
- 研究 2026 年法律變更，包括 Clean Slate 法案與大麻檔案清除
- 建立 URL 模式，以便系統性地逐州收集資料
- 識別現有爬取資料的覆蓋缺口
請勿在以下情況使用此技能：
- 解釋法律含義（請使用
national-expungement-expert） - 建置使用者介面或元件
- 向使用者提供法律建議
- 與法律資料無關的一般網路爬取
核心指令
1. 權威來源層級
在研究檔案清除法律時，依以下順序優先使用來源：
第 1 層（主要權威）：
├── 州議會網站（法規條文）
├── 州法院行政辦公室
└── 州檢察長出版物
第 2 層（官方次要來源）：
├── 州律師公會指南
├── 法院自助中心
└── 公開法律資料庫（public.law, justia.com）
第 3 層（有價值的第三層來源）：
├── 法律援助組織（LSC 受贈機構）
├── 法學院診所
└── 更生組織（CCRC, NACDL）
第 4 層（僅供驗證）：
├── 商業法律資料庫
├── 關於法律變更的新聞文章
└── 律師部落格文章
識別暗語：新手會爬取第一個 Google 結果。專家知道 courts.{state}.gov 包含自助表單，而 legislature.{state}.gov 包含法規條文，兩者都需要。
2. 各州 URL 模式知識
各州的法律資源組織方式不同。掌握這些模式：
統一法院系統（法院擁有所有資源）：
加州：courts.ca.gov/selfhelp-expungement.htm
奧勒岡州：courts.oregon.gov/programs/exp/Pages/default.aspx
華盛頓州：courts.wa.gov/forms/?fa=forms.contribute&formID=101
分立式系統（立法機關與法院分開）：
德州：txcourts.gov（表單）+ texas.public.law（法規）
紐約州：nycourts.gov（表單）+ nysenate.gov/legislation/laws（法規）
佛羅里達州：flcourts.gov（表單）+ leg.state.fl.us/statutes（法規）
Public.law 州（優良的法規代管）：
oregon.public.law, california.public.law, texas.public.law
michigan.public.law, washington.public.law
識別暗語：知道 apps.leg.wa.gov/RCW/ 是華盛頓州的法規資料庫，而 leg.wa.gov 是一般立法機關網站——RCW 子網域才是實際法律條文的所在地。
3. 2026 年法律環境認知
截至 2026 年，以下重大變更會影響研究：
Clean Slate 州（已通過自動清除）：
- 賓夕法尼亞州（2018）、猶他州（2019）、紐澤西州（2019）、密西根州（2020）
- 加州（2020）、康乃狄克州（2021）、德拉瓦州（2021）、維吉尼亞州（2021）
- 奧克拉荷馬州（2022）、科羅拉多州（2022）、紐約州（2023）、明尼蘇達州（2023）
- 馬里蘭州（2024）、伊利諾州（2024）、奧勒岡州（2025）
大麻檔案清除（特定法規）：
- 大多數州現在有獨立的大麻檔案清除條款
- 搜尋「cannabis conviction」以及「expungement」
- 檢查是否適用追溯日期
2025-2026 年需驗證的法律變更：
- 奧勒岡州 HB 2316（擴大資格）
- 加州 AB 1076（擴大自動救濟）
- 查閱 CCRC 的權利恢復計劃以獲取最新狀態
識別暗語：知道「自動清除」並不意味著立即生效——賓夕法尼亞州的 Clean Slate 對逮捕有 10 年的等待期，且因犯罪類型而異。研究必須捕捉這些細微差別。
4. Firecrawl 設定專業知識
在設定爬取任務時：
提取 Schema 設計：
// 對於法規頁面，提取：
{
statuteCitation: "string", // 例如 "ORS 137.225"
title: "string", // 例如 "Setting aside conviction"
fullText: "string", // 完整法規條文
effectiveDate: "string", // 當前版本生效日期
lastAmended: "string", // 最近修訂日期
subsections: "array", // 解析後的子章節
}
// 對於法院自助頁面，提取：
{
stateName: "string",
expungementPageUrl: "string",
formsLibraryUrl: "string",
selfHelpUrl: "string",
contactPhone: "string",
feeScheduleUrl: "string",
}
// 對於表單，提取：
{
formNumber: "string", // 例如 "MC-440"
formTitle: "string",
pdfUrl: "string",
applicableTo: "array", // ["misdemeanor", "arrest"]
lastUpdated: "string",
}
政府網站的速率限制：
rateLimit: 2, // .gov 網站每秒最多 2 個請求
timeout: 90000, // 政府網站可能較慢
maxRetries: 3, // 逾時時重試
waitFor: 3000, // 等待現代法院網站的 JavaScript
識別暗語：知道對於法規頁面要設定 onlyMainContent: true（跳過導航框架），但對於表單頁面要設定 onlyMainContent: false（表單連結通常位於側邊欄）。
5. 資料驗證檢查清單
爬取後，驗證以下項目：
□ 法規引用符合官方格式（例如「ORS」而非「Or. Rev. Stat.」）
□ 生效日期可解析且合理（非未來日期，也不過於陳舊）
□ URL 有效且返回 200 狀態碼
□ PDF 表單連結實際上能下載 PDF（而非 HTML 錯誤頁面）
□ 電話號碼格式一致
□ 費用金額為數字且合理（一般範圍 $0-$500）
□ 州代碼提取正確（注意模糊的 URL）
常見提取錯誤：
- 「oregon.public.law」誤匹配到「la」（路易斯安那州）而非「or」（奧勒岡州）
- 法規條文在 10,000 字元處截斷（請增加限制）
- 表單「最後更新」日期格式不一致
- 將特定縣的 URL 誤認為州級資料
6. 缺口分析流程
為了識別某個州的遺漏資料：
# 檢查現有資料
ls src/data/scraped/states/{state}/
# 完整覆蓋應包含的檔案：
# - statutes.json（從法規條文提取的資格規則）
# - court-system.json（法院 URL、聯絡資訊、表單連結）
# - forms/（實際 PDF 表單）
# - fees.json（申請費用）
# - counties/（特定縣的法院資料）
# 與州資料檔交叉比對
grep -l "waitingPeriods\|eligibilityRules" src/data/states/{state}.ts
填補缺口的優先順序：
- 法規（所有規則的基礎）
- 法院表單（使用者實際需要提交的檔案）
- 費用資訊（使用者需要預算）
- 縣級聯絡資訊（提交地點）
- 西班牙語資源（可及性）
反模式
絕對不要做的事：
- 不加速率限制就爬取 - 政府網站會封鎖你
- 依賴次要來源獲取法規條文 - 務必與主要來源核對
- 假設 URL 模式一致 - 每個州都不同
- 忽略生效日期 - 法律會變更；爬取資料需要時間戳記
- 在沒有州級背景的情況下爬取縣級網站 - 縣級規則補充而非取代州法
- 跳過自助部分 - 通常有最清楚的資格摘要
- 把各州視為相同 - Clean Slate 州具有本質上不同的流程
常見錯誤：
❌ 爬取維基百科獲取法規條文
✅ 爬取州立法機關的官方法典
❌ 使用 findlaw.com 作為主要來源
✅ 使用 findlaw.com 找到引用，然後爬取官方來源
❌ 假設「expungement」是唯一術語
✅ 搜尋：expungement, sealing, set-aside, dismissal, destruction, pardons
❌ 將等待期視為簡單數字
✅ 捕捉特定犯罪的等待期（重罪 vs 輕罪 vs 逮捕）
專案特定背景
此技能專為 全國檔案清除指南 專案設計：
現有基礎設施
- Firecrawl 腳本：
scripts/firecrawl/ - 任務定義：
scripts/firecrawl/jobs.ts（P0-P4 優先級任務） - URL 設定：
scripts/firecrawl/config.ts（全部 50 州） - 輸出路徑：
src/data/scraped/states/{state}/ - 州資料：
src/data/states/（每個州一個 TypeScript 檔案）
執行爬取
# 先設定 API 金鑰
export FIRECRAWL_API_KEY=your_key
# 執行 P0（州法規 + 法院）- 約 $0.20 成本
npx tsx scripts/firecrawl/run-p0.ts
# 預覽試跑
npx tsx scripts/firecrawl/run-p0.ts --dry-run
# 查看報告
cat scripts/firecrawl/reports/p0-*.json
資料流程
Firecrawl 爬取 → src/data/scraped/{state}/*.json
↓
人工審閱 + 清理
↓
整合至 src/data/states/{state}.ts
↓
由資格精靈 + PDF 產生器使用
參考資料
請參閱 references/ 資料夾中的：
url-patterns-by-state.md- 全部 50 州的完整 URL 模式clean-slate-timeline.md- 各 Clean Slate 法律通過與生效的時間表firecrawl-schemas.md- 所有使用的提取 schema
範例工作流程
使用者請求：「研究加州 2026 年的檔案清除法律，並爬取最新資料」
代理人工作流程：
- 檢查現有資料：
ls src/data/scraped/states/ca/ - 在
california.public.law驗證目前法規版本 - 透過 CCRC 或新聞搜尋檢查 2025-2026 年法律變更
- 若 URL 有變，更新
scripts/firecrawl/config.ts - 執行目標爬取：將加州特定 URL 加入 P0 任務
- 根據已知法規引用驗證提取資料
- 記錄發現的任何缺口或變更