Tw Law

Taiwan interior-renovation submission document assistant prototype. It turns procedure routing, submission packets, correction notices, source references, and human confirmation into auditable MCP workflows for New Taipei City.

Project at a glance

cc-crossbeam-tw is a source-bound MCP server prototype for Taiwan interior-renovation submission work. The project keeps the legal/auditability domain in tw_law_mcp and treats AI as a bounded assistant:

• procedure routing and confidence signals for New Taipei City workflows;
• document packets, metadata manifests, correction-item normalization, and draft responses;
• source snapshots, audit gates, and human-in-the-loop confirmation; and
• metadata-only inputs, source snapshots, and human confirmation for uncertain cases.

This is a public prototype, not a legal-opinion, professional-signoff, or approval-guarantee service.

Public links

• Project Pages — public workflow overview and examples.
• Packaging ADR — standalone MCP packaging decision.
• Feature matrix — workflow mapping and scope comparison.
• Scenario feature matrix — supported workflow scenarios and evidence boundaries.
• Contribution guide — setup, verification, and privacy rules for changes.

The detailed Traditional Chinese product description and current delivery status follow below.

台灣室內裝修送審文件助手原型，首發場景聚焦新北市室內裝修申請與補正流程。

這個專案要處理的是建築師、室內裝修業者、代辦人員反覆遇到的文件整理問題：

這個案子到底走哪個程序？要備哪些文件？主管機關公文上的補正意見，每一條對應到什麼資料、圖說、法規來源或人工確認？

tw-law-mcp 把這些判斷拆成可追溯的 MCP 工具，讓 Codex、Claude Code 或其他支援 MCP 的 AI 助手在回答時先查本機工具與來源快照，而不是憑印象補法條、補文件或直接下結論。

GitHub Pages 上手頁位於 docs/index.html。

適合誰

• 建築師事務所：整理室內裝修圖說審核、竣工查驗、變更使用併室內裝修竣工查驗的文件缺口。
• 室內裝修業者：把補正公文拆成逐條任務，確認哪些資料要回頭找業主、廠商或專業人員補。
• 代辦與行政窗口：先做程序分流、送件 packet、缺件清單與回覆草稿，再交由專業人員確認。
• AI/工程團隊：把室內裝修送審流程包成 deterministic、source-bound 的 MCP server，避免 agent 任意編造。

能幫上什麼忙

先講邊界

這不是法律判斷工具，也不是專業簽證工具。

在程序分流、文件 routing 與補正流程中，若資料不足、涉及專業裁量或低信心，流程會 fail closed 並產生 human-in-the-loop 待確認項目；不會以這些輸出取代專業判斷。

可以怎麼問 AI 助手

本機 MCP 設定完成後，可以在 Codex 或 Claude Code 內這樣問：

請使用 tw-law-mcp 先跑 run_phase_acceptance。
接著根據我提供的已遮罩文件文字與檔案 metadata，判斷目前比較接近：
圖說審核、竣工查驗、變更使用併室內裝修竣工查驗、簡易室內裝修。
請輸出 procedure_stage 信心分數、需要的人工確認問題、會用到的 corpus packs、產出的 artifacts，以及不能判定的原因。
不要輸出法律意見、合規保證、消防設計結論、材料真偽結論或審查必過承諾。

其他常見問題：

• 「這份案件的檔案 metadata 在這裡，幫我判斷比較接近圖說審核還是竣工查驗？信心多高？還缺什麼資訊？」
• 「幫我依竣工查驗階段，產生新北市室內裝修的送件文件 packet。」
• 「這是遮罩過的補正公文，幫我拆成逐條補正項目，哪些需要建築師、消防或材料廠商確認？」

資料隱私原則

不要直接把以下內容貼進 prompt：

• 未遮罩姓名、地址、電話、身分證字號。
• title block、原始圖說、raw drawing、raw PDF。
• 客戶授權範圍不明的完整申請文件。

建議只提供：

• 已遮罩公文文字。
• 檔名、圖號、頁名、sheet type、文件類型等 metadata。
• 已去識別化 fixture 或測試案例。
• 人工確認答案與 acceptance output。

工具本身也以 metadata-only boundary 設計，避免 raw drawing 或 raw PDF 內容直接進入 agent prompt。

快速開始

git clone https://github.com/trionnemesis/cc-crossbeam-tw.git
cd cc-crossbeam-tw
python3 scripts/tw_law_mcp_stdio.py

這會啟動一個持續等待 JSON-RPC 輸入的 long-running MCP process；完成測試後可用 Ctrl-C 結束。

• Codex App：專案設定在 .codex/config.toml。
• Claude Code：專案設定在 .mcp.json。
• 啟動後建議先執行 python3 -m unittest discover -s tests 與目標 acceptance script。run_phase_acceptance 是 aggregate trust gate；目前預期會以非 0 結束並回報 all_passed=false，因為 production G2 尚未接入 approved real de-identified cases，unsupported synthetic fixture claims 必須 fail closed。

目前狀態

• 版本：0.4.0 prototype。
• 首發地區：新北市。
• 首發案型：室內裝修。
• 主線已完成 1~6 組開發：P0 source-policy、procedure/HITL、G2 synthetic fixture contract、metadata extraction、jurisdiction registry、standalone MCP packaging。
• Phase 2.1-2.6 / Step 6 已完成：split data layout、source adapter contracts、scenario MCP tools、hardened scenario matrix evaluation、two-stage contractor flow skeleton。
• 目前使用 P0 fixture corpus 與 synthetic de-identified cases 驗證流程契約；production 導入前仍需 approved real de-identified cases 與 live official-source ingestion/refresh workflow。G2 synthetic baseline 只能證明 schema、gate 與 HITL contract，不能支撐真實案件 claim。
• 新北市以外 jurisdiction 已預留 registry，但目前 fail closed，不主動作答。

本專案的產品流程概念源自 cc-crossbeam 的文件審查與補正回覆流程；只借流程，不搬美國 ADU 法規。對照表見 docs/cc-crossbeam-feature-matrix.md。

python3 -m unittest discover -s tests
python3 scripts/run_phase_acceptance.py

tw_law_mcp/     # MCP server core and data
scripts/        # stdio entrypoint and acceptance scripts
tests/          # unittest coverage
fixtures/       # G2 contract baseline
docs/           # GitHub Pages, ADR, feature matrix