企业官网建设流程全解析

Court Payment Order Assistant：k-skill 中韩国电子诉讼「支付命令（督促程序）」申请辅助技能全解析

【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill

导读

court-payment-order-assistant是 k-skill 技能集中面向韩国法院电子诉讼（전자소송）「支付命令 / 督促程序（지급명령, 독촉）」申请场景的 Agent 技能。它把用户口述的债权人与债务人信息、请求权金额、请求原因与证明资料整理成可复查的申请书草案、缺项追问清单与浏览器 handoff 步骤，让 Agent 在不触碰登录、认证、电子签名、缴费与最终提交的前提下，把用户推到合法合规的「最后一米」。读完本文，你将掌握该技能的输入数据模型、三阶段工作流、合法边界规则、BrowserOS/runtime CDP 接管策略，以及对应的源码级实现与测试验证依据。

技能定位：参考型起草助手，不是法律代理

技能的核心承诺是：为正式提交支付命令（독촉）申请做前置文书准备，包括申请书草案、缺项追问、附件清单与浏览器接管步骤。它明确不提供法律咨询、不判断胜诉可能性、不代为确定管辖法院、不代办最终提交。

依据 packages/k-skill-cli/skills/court-payment-order-assistant/instruction.md 的定义，该技能完全围绕「合法边界」设计。技能元数据中category: legal、locale: ko-KR、phase: v1也印证了它是 v1 阶段的韩语法律辅助技能（见 court-payment-order-assistant/skill.json）。

法律安全运行的四条铁律

为了避免触碰韩国《律师法》中「无执照法律事务处理」的红线，技能被严格限定在以下四个框架内运行：

1. 仅限本人案件（본인 사건 전용）：只服务用户为回收自己的债权而准备文书的场景；禁止有偿代写、中介、撮合第三方的诉讼或支付命令文书。一旦出现这类请求，技能应引导用户咨询律师或法务士（변호사/법무사）。
2. 产出物永远是参考用草案（참고용 초안）：申请书草案与检查清单必须标注「不保证法律效力」，并固定提示用户在提交前请律师、法务士或法院的「独自打官司（나홀로소송）」指南确认。
3. 不做法律判断（법률 판단 금지）：不判断胜诉可能性、不确认管辖、不判断请求原因的法律有效性、不提供诉讼策略。管辖法院由用户最终确认。
4. 最终提交由用户亲自完成：登录、认证、电子签名、缴费、提交只在用户本人的官方门户会话中进行，技能只准备到「输入值 handoff」。

这套边界不仅写在文档里，也以可执行代码的形式固化在包内。在 packages/court-payment-order-assistant/src/intake.js 中，BOUNDARIES常量固定声明了三条边界：

const BOUNDARIES = [ "This helper does not give legal advice.", "The user must complete login, certificate authentication, electronic signature, payment, and final submit manually.", "Stop before final submit, electronic signature, filing fee payment, or any irreversible court filing action." ]

适用时机与典型触发语

当用户表达以下意图时，应激活该技能（来自 instruction.md 的 When to use 小节）：

• "떼인 돈 지급명령 신청 준비해줘"（帮我把被拖欠的钱准备支付命令申请）
• "전자소송에서 지급명령 신청서 입력 도와줘"（帮我在电子诉讼上填支付命令申请书）
• "채무자 정보랑 증빙으로 지급명령 초안 만들어줘"（用债务人信息和证明做支付命令草案）
• "로그인은 내가 할 테니 입력할 내용 정리해줘"（登录我自己来，帮我整理要输入的内容）

环境前置要求与浏览器策略

运行环境

• Node.js 18+：包声明于 packages/court-payment-order-assistant/package.json（"engines": { "node": ">=18" }），CLI 入口也要求 18+（见 court-payment-order-assistant/SKILL.md）。
• 运行时依赖仅一项：k-skill-browser-runtime@^0.4.0，用于复用跨技能统一的 STOP_CODES 停止规则分类。

真实浏览器并非必需

技能的核心产出物（支付命令/督促草案、必要文件清单、输入值 handoff）在不启动任何浏览器的情况下生成。浏览器只出现在用户手动阶段，此时推荐顺序为：

1. BrowserOS/runtime CDP 优先：附加（attach）到用户自己启动的 BrowserOS GUI 会话上，通过环境变量KSKILL_BROWSEROS_CDP_URL指定地址，默认http://127.0.0.1:9100。技能自身不会launch BrowserOS，也不会以 headless 方式运行浏览器。
2. 手动浏览器兜底：当 CDP 不可用，或遇到登录、证书、安全程序、CAPTCHA、维护页面等阻塞时，输出精确的字段值交给用户手动录入。

需要用户亲自处理的环节包括：电子诉讼登录、공동/금융인증서（共同/金融认证书）或 간편인증（简便认证）、安全程序、电子签名、인지대/송달료（印花税/送达费）缴费、最终提交。

已探明的公开访问路径

官方门户的当前稳定入口为：

https://ecfs.scourt.go.kr/psp/index.on

该地址同时被硬编码为包的入口常量（见 packages/court-payment-order-assistant/src/index.js 第 6 行：const COURT_PORTAL_URL = "https://ecfs.scourt.go.kr/psp/index.on"）。

公开状态下可观察到的页面要素包括：登录/用户注册、서류제출（文书提交）、민사 서류（民事文书）区域；文档撰写区域会显示「登录后可用」的边界提示；在 나홀로소송/도움말（独自打官司/帮助）区域可找到支付命令（督促）的说明入口。注意：https://ecfs.scourt.go.kr/ecf/index.jsp可能被重定向到维护/错误页面，因此稳定入口以/psp/index.on为准。

三阶段工作流：从采集到接管

阶段一：追问必备事实（Ask for required facts）

使用包的buildRequiredQuestions与validateIntake完成输入归一化与校验：

const { buildRequiredQuestions, validateIntake } = require("court-payment-order-assistant") const validation = validateIntake(input) if (!validation.canDraft) { console.log(buildRequiredQuestions(input)) }

必备信息表（来自 instruction.md）：

源码层面，validateIntake通过 8 个必填字段路径逐一检查（见 packages/court-payment-order-assistant/src/intake.js 中REQUIRED_FIELDS）：

校验结果包含三个关键输出：

• canDraft：全部必填字段齐全才为true；
• missingFields：缺失项列表（格式字段路径: 提示文案）；
• warnings：非阻塞告警，例如「채무자 주소가 불명확하면 지급명령 송달이 실패할 수 있습니다」（债务人地址不明确可能导致支付命令送达失败）、「관할 법원은 사용자가 최종 확인해야 합니다」（管辖法院须由用户最终确认）。

buildRequiredQuestions会把缺失字段映射为可朗读的韩语追问问题，并按优先级排序：债务人字段 > 请求字段 > 证据 > 其他（源码questionPriority：debtor.*为 1，claim.*为 2，evidence为 3，其余为 4），确保最先追问最关键的信息。

阶段二：生成草案与检查清单（Prepare a draft and checklist）

const { buildPaymentOrderDraft } = require("court-payment-order-assistant") const draft = buildPaymentOrderDraft(input)

buildPaymentOrderDraft返回结构（见 packages/court-payment-order-assistant/src/index.js）：

• status："ready_for_user_review"（可复查）或"needs_more_information"（信息不足）；
• parties：{ creditor, debtor }，即归一化后的当事人信息；
• court：用户最终确认的管辖法院（{ name, basis }）；
• claimStatement：由请求意旨、本金、清偿期、迟延利息拼接成的申请书核心文句，例如「채무자는 채권자에게 3,500,000원 및 지연손해금을 지급하라. 청구원금 3,500,000원. 변제기 2026-06-01.」；
• causeStatement：请求原因陈述；
• evidenceList：附件证明清单；
• reviewChecklist：5 项复查清单——① 债权人姓名与地址是否与居民登记/营业执照信息一致；② 债务人地址是否为实际可送达的最新地址；③ 请求金额、清偿期、迟延利息起算日是否与证明一致；④ 合同书、转账记录、税票、催告短信等举证文件是否备齐；⑤ 管辖法院与印花税/送达费在电子诉讼界面最终确认；
• missingFields与warnings：承接阶段一的校验结果；
• stopBefore：明确列出「不得越过」的节点——전자서명（电子签名）、인지대/송달료 결제（印花税/送达费缴费）、최종 제출（最终提交）、사건 접수 후 취소가 어려운 단계（案件受理后难以取消的阶段）；
• disclaimer：固定免责声明「참고용 초안이며 법률 자문이 아닙니다. 제출 전 본인이 원문과 증빙을 검토하거나 전문가에게 확인하세요.」（参考用草案，非法律咨询；提交前请本人审查原文与证明或向专家确认）。

一个值得注意的源码细节：当输入不完整时buildPaymentOrderDraft({})会返回status: "needs_more_information"且claimStatement为空字符串，绝不会伪造一个「0 元」的假请求文句——对应测试「Given incomplete intake When drafting Then no fake zero-won claim is emitted」（见 packages/court-payment-order-assistant/test/index.test.js）。

输入归一化规则（normalizeIntake）

• 金额：接受"3,500,000"、"3500000원"等带千分位/货币单位/空白的写法，去除[,원\s]后转为整数 KRW；必须为非负整数，否则抛出RangeError("claim.amount must be a positive integer KRW amount")；
• 日期：严格YYYY-MM-DD格式，否则抛出RangeError("date must be YYYY-MM-DD")；
• 当事人：name、address、phone、registrationNumber（注册号，可选）；
• 请求：amount、cause、dueDate、demand、interest（迟延利息描述，可选）；
• 证据：接受{ title, note }或{ name, description }，过滤掉无标题项；
• 法院：name（法院名）与basis（管辖依据，可选）；
• 所有字符串字段经clean处理：压缩连续空白并去除首尾空格。

阶段三：浏览器 handoff（Browser handoff）

const { buildBrowserHandoff } = require("court-payment-order-assistant") console.log(buildBrowserHandoff(input))

兜底顺序（fallback order）：

1. BrowserOS/runtime CDP：附加到用户启动的 BrowserOS GUI 会话（默认http://127.0.0.1:9100），在用户手动登录后，用于检查官方门户并填写可逆的草稿字段；
2. 手动浏览器：若 BrowserOS CDP 不可用，或认证、证书、安全模块、CAPTCHA、维护等阻塞了自动化，则把精确字段值交给用户手动录入。

buildBrowserHandoff返回结构（源码见 packages/court-payment-order-assistant/src/index.js）：

• entryUrl：官方门户入口https://ecfs.scourt.go.kr/psp/index.on；
• runtimeProvider："browseros"；
• browserosCdpUrl："http://127.0.0.1:9100"；
• launchesBrowser：false（技能永不启动浏览器、永不 headless）；
• fallbackOrder：两条通道（browseros-cdp/manual-browser）及其目的说明；
• steps：5 步操作指引——附加 CDP → 用户手动登录并处理证书/安全提示 → 导航到서류제출 > 민사 서류 > 지급명령或督促相关申请书 → 按当事人/请求/原因/证据清单填写可逆草稿字段 → 在任何不可逆操作前暂停让用户复查（CDP 不可用时交还手动录入）；
• draft：内嵌阶段二的完整草案；
• stopCodes/stopRules/stopRulesStructured：停止规则三形态。

停止规则：结构化 STOP_CODES 分类

技能通过k-skill-browser-runtime的STOP_CODES定义了一套跨技能共享的停止规则分类，Agent 可基于同一套结构化原因进行分支决策。HANDOFF_STOP_RULES完整映射如下（源码）：

这一点在 packages/court-payment-order-assistant/test/index.test.js 中被严格验证：测试断言handoff.stopCodes与 6 个STOP_CODES一一对应、每项规则均有非空文案、steps与stopRules中不出现任何「自动提交/自动登录/自动缴费/自动签名」表述，从侧面保证边界规则的完整性。

停止红线（Stop rules）

• 不得点击最终提交（final submit）；
• 不得执行电子签名（electronic signature）；
• 不得代缴 인지대（印花税）或 송달료（送达费）；
• 不得绕过登录、证书、安全模块、CAPTCHA 或维护页面；
• 不得向用户保证申请在法律上充分或必然成功。

完成判定（Done when）

当且仅当以下条件全部满足时，技能任务才算完成：

• 已收集到必备事实，或已返回缺失项追问；
• 已为用户生成草案/检查清单供复查；
• 已通过 BrowserOS/runtime CDP 或文档化兜底方式确认官方门户入口与登录必需边界；
• 浏览器 handoff 停在签名、缴费与最终提交之前。

失败模式（Failure modes）

技能文档明确列出的失败场景包括：

• 电子诉讼门户维护或重定向；
• 登录、证书、安全模块、CAPTCHA、弹窗或会话超时；
• 债务人地址未知或管辖错误；
• 请求原因或金额缺少证明；
• 用户要求法律判断、保证结果，或在未复查的情况下直接最终提交。

对应地，court-payment-order-assistant/SKILL.md 中的三条硬规则也适用于脱离 CLI 运行的情形：未经用户即时明确批准，绝不执行缴费/发送/最终提交/取消/公开发布；绝不在聊天、文件或 shell 参数中索要、打印或存储明文凭据；绝不绕过法律、物理在场、CAPTCHA、身份核验或电子签名边界。

备注与合规提示

• 本技能不使用任何代理、API Key 或密钥；
• 它不是法律建议。涉及事实争议、大额债权、时效问题、经营性债务或债务人地址不明时，应建议用户寻求专业审查；
• 包版本为0.2.3（MIT 许可），依赖k-skill-browser-runtime@^0.4.0（变更历史见 packages/court-payment-order-assistant/CHANGELOG.md）；
• 包的运行方式是作为 Agent 技能的辅助库被引用（require("court-payment-order-assistant")），完整用法示例见 packages/court-payment-order-assistant/README.md。

总结

court-payment-order-assistant展示了法律场景 Agent 技能的一种安全范式：把「文书准备」与「不可逆行为」彻底解耦。文书准备（信息采集、草案生成、清单复查、可逆字段录入指引）可以完全自动化；而登录、认证、签名、缴费、提交这些法律与身份边界上的动作，则被结构化 STOP_CODES 明确标记并强制交还给用户。对任何想要在司法、金融、政务等强合规领域构建 Agent 工具的开发者而言，这份技能的文档、源码与测试组合（instruction.md、src/index.js、src/intake.js、test/index.test.js）本身就是一份值得直接参考的实现范本。

【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill