Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/legal-harness-init

@5fb69a0
Run it yourself

法律 AI 上下文初始化。为律师、法务等法律工作者按业务梳理个人、团队与事项三层的协作规则,列出各层的规则来源、维护人和保存位置,将已确认的个人或事项规则安全合并到 AGENTS.md/CLAUDE.md。用于首次配置或更新 AI 工作上下文、建立法律安全基线或设置相关指令文件时。不要用于直接审合同、研判案件、起草文书、创建项目脚手架或开发 Skill。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/legal-harness-init

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈122 tokens for metadata: the name and description. ≈4.2k when used: this file. ≈52k more on demand in 55 files.

Description uses 2.5% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈199 characters, or 2.5%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

法律 AI 上下文初始化

把个人工作习惯、团队规程和事项要求梳理成 AI 可以复用的工作上下文。客户端调用名是 $legal-harness-init。配置写入、会话加载和行为验证分别记录:

  1. CONFIG_WRITTEN:文件与受管区块存在。
  2. INSTRUCTIONS_DECLARED:人工证据声明新会话加载了精确来源。
  3. BEHAVIOR_DECLARED:人工证据声明四类行为探针通过。
  4. BEHAVIOR_VERIFIED:由受信 runtime 采集器绑定的会话证据自动确认;本版本尚未提供该采集器,不得宣称此状态。
<!-- skill-lint:constraint COMPLETION-STATUS-NO-OVERCLAIM -->

如果无法启动新会话,必须报告 CONFIG_WRITTEN + NOT_VERIFIED。人工会话摘要最多升级为 DECLARED,不得扩大成已加载或行为已验证。

首次使用或判断平台是否支持时,读 支持矩阵与完整示例。检测到平台不等于客户端已实际加载;本 Skill 写入的是协作约定,不是 runtime 权限拦截器。

做演示,或想看同一位律师如何为不同业务分别配置事项上下文,读 劳动争议与合同审查双业务示例。

适用边界

在以下条件同时满足时使用:

  • 用户是律师、法务、合规、知识产权或其他法律工作者;
  • 用户要初始化或更新法律 AI 工作上下文、协作规则、AGENTS.md、CLAUDE.md 或 harness 基线。

不要用于:

  • 合同审查、案件研判、检索、文书起草等法律业务;
  • .claude/、.codex/、skills、docs 等项目脚手架初始化(改用 project-init);
  • Skill 或代码开发。

输入参数

参数 默认值 说明
--guide-mode quick quick / guided / team
--level 自动判断 脚本写入仅 user / project;组织规则由团队指定来源与维护人,在适用事项中引用
--platforms 当前 runtime + 可写已安装平台 平台 key,逗号分隔
--runtime 自动检测 调用方明确知道当前平台时传给 detect.sh
--project-type 询问 litigation / transactional / ip / in-house / research;只路由问题,不提供标准答案
--privacy-mode strict strict / local / team
--mode create create / update / append;三者均只 upsert 受管区块
--block-id 按模块指定 稳定 marker id,见“受管区块”
--dry-run 否 只展示候选 diff,不写入
--model env 白名单探测 init-environment 受管区块需要时兜底;ANTHROPIC_MODEL / OPENAI_MODEL / CLAUDE_MODEL / GLM_MODEL / MY_MODEL 命中即用
--action init record-init-env.sh 的操作类型:init / update / append
--record-init-env true write.sh 真实落盘后是否自动调 record-init-env.sh;true / false;批量场景可关
--init-action init write.sh 自动调 record-init-env.sh 时传的操作类型

将旧参数 --preset 解释为 --project-type,并提示新名称;项目类型只决定追问路线,不能替用户填答案。

第一步:检测环境

运行:

bash scripts/detect.sh
# 调用方明确知道当前平台时:
bash scripts/detect.sh --runtime codex

读取 schema v3 的:

  • runtime_candidates:候选平台、信号、置信度、是否可写;
  • current_runtime:只在显式声明或最高置信度唯一命中时设置;
  • harnesses_detected:已安装平台;
  • project_level:AGENTS.md / CLAUDE.md 与 project-init 复合证据。

检测脚本只读取已知目录、文件存在性、行数及 runtime 环境变量是否存在,不读取环境变量值、配置正文、Token 或凭证。详见 references/03-harness-detection.md。

第二步:选择引导模式与隐私模式

quick:5 分钟最小安全基线

默认使用。用一轮最多 5 个问题确认:

  1. 角色和主要工作类型是什么?
  2. 常见交付物及期望格式是什么?
  3. AI 可做、必须先确认、绝对禁止的动作分别是什么?
  4. 采用 strict、local 还是 team 隐私模式?
  5. 哪些决策、证据变化、期限和交付版本需要留痕,项目已有哪个权威载体?

每组答案只解释一句“为何需要”。不要跳过必要安全问题,也不要强迫用户完成全部教学章节。生成 M1、M2、M3、法律安全基线和 M5;项目级再生成最小 M6—M8。

guided:逐模块共同设计

按 M1→M8 逐项引导,参考 references/04-modules.md 与 templates/modules/。用户卡住时给候选维度,不替用户决定,不直接套用范例。

team:三层治理

先读取 references/20-team-layering.md,分别确认:

  • 组织层:稳定且不可被项目弱化的安全、保密、审批与工具政策;
  • 项目层:事项范围、阶段、事实入口、时限与项目工作流;
  • 个人层:表达、格式与非强制偏好。
<!-- skill-lint:constraint TEAM-LAYER-PRECEDENCE -->

在平台允许配置的同一治理范围内,冲突时必须遵循法律安全边界/组织强制政策 > 项目具体规则 > 个人偏好;同层冲突请求负责人确认并留痕。AGENTS.md/CLAUDE.md 是持久默认基线,不得把这条团队层规则解释成对平台指令层级或用户当前明确授权的通用改写。

三档隐私模式

按 references/18-privacy-and-context.md 执行:

  • strict:AGENTS.md 只写项目代号、类型、阶段、关键时点和规则,不写真实当事人、案号、金额、联系方式或身份号码。
  • local:真实事实写入权限为 0600 且被 .gitignore 排除的 .legal-context.local.md;AGENTS.md 只保留入口和按需读取规则。
  • team:真实事实只进入组织批准的受控团队载体;AGENTS.md 记录载体路径、访问条件和脱敏/对外规则,不记录凭证或高敏个人身份号。

第三步:生成法律安全基线

<!-- skill-lint:constraint PRIVACY-MINIMUM-CONTEXT -->

M4/M5 必须覆盖四项契约,且项目配置不得直接包含凭证、高敏身份号或与协作无关的可识别案件信息:

  • 权限契约:读、写、外发、提交、删除、支付分别需要什么授权;外部或不可逆动作必须有覆盖具体动作的授权,已有明确授权不重复询问,超出范围才补确认。
  • 保密契约:默认最小必要上下文;禁止把客户材料、身份号码、凭证或未脱敏事实写入公开配置、日志、提交或外部服务。
  • 溯源契约:区分材料事实、推断与建议;法律结论保留来源、时间和适用范围;信息不足时明确缺口。
  • 人工裁决契约:AI 不作最终法律判断;期限、金额、主体、法条引用和对外交付必须由指定人员复核。

回溯载体按事实性质选择,并优先复用项目已有权威来源:

  • 决策/取舍 → 已有 DECISIONS.md 或项目指定决策载体;
  • 证据材料新增、来源或证明目的变化 → 证据目录/证据索引/项目指定证据日志;
  • 期限与责任人 → 已有 TASKS.md、期限台账或经授权的日历;
  • 交付物版本和用户可见变化 → CHANGELOG.md 或项目指定交付记录。

项目未启用某类文件时先询问或标记待补充,不为形式完整创建空文档。详见 references/06-audit-trail-contract.md。

第四步:生成最小项目上下文

M6—M8 默认只生成:

# 项目:{项目代号}

- 类型:{项目类型}
- 阶段:{当前阶段}
- 关键时点:{日期 + 事项;未知则写待补充}
- 受控事实入口:{不需要则写“无”}
- 文件结构与权威载体:{沿用项目现有约定}

不要默认询问或写入完整当事人、真实案号、金额、统一社会信用代码。确需使用真实事实时,根据隐私模式写入受控载体。项目类型只用于决定下一条必要问题,参见 references/12-module-project-context.md 和 references/13-module-case-facts.md。

若检测到 project-init 复合证据,只补法律安全、回溯和受控上下文入口,不改项目脚手架。

第五步:预览三层清单与受管区块

生成或更新时,无论采用哪种引导模式,先在答复中给出三层规则清单,逐层列出规则来源、维护人、保存位置、本次处理。多个事项各列一行;不在本次写入范围的层标明沿用、仅引用、待确认或不适用。先展示清单及对应草稿或差异;仅需草稿时直接交回。写入后按实际回执更新清单。

每个模块使用固定 block-id,一次只更新一个逻辑区块:

内容 block-id
角色 m1-role
工作流 m2-workflow
协作偏好 m3-collab-style
法律安全基线(含 M4) legal-safety-baseline
回溯契约 m5-traceability
项目上下文 m6-project-context
受控事实入口 m7-fact-entry
文件结构 m8-file-structure
初始化环境(受 legal-harness-init 自动 append) init-environment
<!-- skill-lint:constraint MANAGED-BLOCK-SAFE-UPSERT -->

write.sh 必须自动添加形如 <!-- legal-harness-init:m1-role:start --> 的唯一成对 marker,并按实际目标路径去重;内容临时文件不得自行添加外层 marker。先运行内容校验,再用 --dry-run 展示合并候选 diff。

第六步:校验并安全写入

bash scripts/validate-content.sh \
  --file <模块内容文件> \
  --privacy-mode <strict|local|team>

bash scripts/write.sh \
  --content-file <模块内容文件> \
  --level <user|project> \
  --platforms <key,key> \
  --mode <create|update|append> \
  --block-id <稳定-id> \
  --privacy-mode <strict|local|team> \
  --project-dir <项目路径> \
  --dry-run

确认 diff 后去掉 --dry-run。脚本必须:

  • 按实际目标路径去重;Codex + OpenClaw 同指向项目 AGENTS.md 时只写一次;
  • 校验 marker 与敏感信息后,在目标同目录构造候选并原子替换;
  • 保存首次写入前的 .bak.legal-harness-init 及权限/哈希元数据,并为每次变化保存唯一快照;
  • 将用户级配置、原始备份、快照和元数据收紧为 0600;
  • 第二次写入相同内容时报告 unchanged,不产生新快照。

需要回退时:

bash scripts/restore.sh --target <AGENTS.md-or-CLAUDE.md>

平台路径与非 AGENTS.md 模式限制见 scripts/README.md。

第六步半:记录初始化环境

write.sh 真实落盘后(v0.4.2+)已自动调一次 record-init-env.sh,agent 无需手动串联。如需关闭(如批量脚本场景)传 --record-init-env false 即可。详见 references/22-initialization-environment.md 与 templates/modules/init-environment.md。

write.sh 落盘后会自动调,下面命令仅在 --record-init-env false 或需手动补记时使用:

bash scripts/record-init-env.sh \
  --target <项目/AGENTS.md|CLAUDE.md> \
  --action <init|update|append> \
  [--model <model-name>] \
  [--harness <key>] \
  [--harness-version <v>] \
  [--skill-version <v>] \
  [--note "<额外说明>"] \
  [--probe-from-session] \
  [--session-file <已确认的会话文件>] \
  [--dry-run]

脚本半自动采集,env 全部命中即可直接调用:

  • harness(name):默认 source detect.sh 取 current_runtime(schema v3);可用 --harness 显式覆盖
  • harness version:探测 claude --version / codex --version(2s 超时,失败 unknown);非 claude/codex 写 n/a
  • model:env 白名单 ANTHROPIC_MODEL / OPENAI_MODEL / CLAUDE_MODEL / GLM_MODEL / CODEX_MODEL / OPENAI_MODEL_GLM / MYAGENTS_MODEL / QWEN_MODEL / MY_MODEL 探测,全部未命中时:若传 --probe-from-session 则从当前 harness session 反查 model——claude-code/qwenwork/qoderwork/myagents(CC 克隆 jsonl,role=assistant.message.model)、codex(按精确 cwd 匹配 turn_context.payload.model,并发时须传 --session-file)、workbuddy(trace spans toolOutput chat.completion.model);openclaw/orca 暂 not_found;仍未命中时拒绝 append 并要求 --model 兜底(不臆造)
  • init skill version:从本 skill 根 SKILL.md frontmatter metadata.version 字段读

脚本必须:

  • 用受管 marker 包裹,append-only 表格行(不覆盖历史)
  • 区块残缺(只 start 或只 end)拒绝 append,提示人工修复
  • 失败关闭:参数非法、符号链接 target、target 不存在、备注未过 strict 校验、candidate marker 不完整或整体结构异常均拒绝
  • 真实写入前建立可校验原始备份和本次快照;dry-run 不改变内容、权限或备份
  • 表格行数 >50 时 stderr 软提示归档(不阻断)
<!-- skill-lint:constraint INIT-ENVIRONMENT-RECORD-ON-WRITE -->

每次 write.sh 真实落盘(不是 dry-run、不是 needs_confirmation)后都已由 write.sh 自动调一次 record-init-env.sh(v0.4.2+,受 --record-init-env 开关控制)。缺这条记录等同于"配置改了但没记工具环境";输出 init_env_status=failed 且 status=*_record_incomplete,整体退出非零。无法获得 model 时不臆造,必须显式传 --model 或回退到 NOT_VERIFIED。

第七步:在新会话验证生效

按 references/19-activation-verification.md 新启动目标 harness 会话,确认加载来源,并执行四类探针:权限、保密、信息缺口、回溯载体选择。

将证据保存为本地临时 key=value 文件后运行:

bash scripts/verify.sh \
  --target <配置文件> \
  --block-id <稳定-id> \
  --session-evidence <证据文件>

证据必须包含 new_session=true、loaded=true、精确 source_path、与当前配置一致的 config_sha256;四项 probe_*=pass 时最多报告 BEHAVIOR_DECLARED。当前没有受信 runtime 采集器,verify.sh 不输出 BEHAVIOR_VERIFIED。配置变化后旧证据失效;当前写入会话的自报不算加载证据。

验收

运行:

bash scripts/test.sh

交付前确认:

  • 三层清单与实际来源、维护人和落点一致,标出缺项;实际写入以对应文件的回执为准;
  • 默认产物没有真实可识别案件信息或凭证;
  • 已有文件的非受管内容完整保留;
  • 多平台同路径只写一次,重复执行零 diff;
  • 原始内容、权限和哈希可恢复;
  • 最终状态没有把 CONFIG_WRITTEN 或人工声明扩大成已加载或行为已验证;
  • 无法新启会话时明确报告 NOT_VERIFIED;
  • 每次 write.sh 真实落盘后都已 record-init-env.sh 追加一条 init-environment 行;缺记录时回执包含 *_record_incomplete / init_env_status=failed 而非宣称完整完成。

依赖

日常初始化开箱即用,无第三方包。需要 Bash 3.2+ 及常见系统工具:awk、grep、sed、stat、diff、mktemp、shasum 或 sha256sum。可选的会话模型探测和可选会话探测、审计回归和正式指令稳定性 checker 另需已安装的 Python 3.9+,不需要额外 Python 包。

禁止事项

  • 禁止替用户决定权限、保密边界或最终法律结论。
  • 禁止把真实案件详情、客户材料或凭证直接写入用户级配置或公开项目配置。
  • 禁止覆盖、删除或重排受管 marker 之外的用户内容。
  • 禁止在 marker 残缺、内容校验失败或目标不明确时写入。
  • 禁止将旧会话、当前写入进程或静态检查当作新会话加载证据。
  • 禁止把手写 key=value 行为证据升格为 BEHAVIOR_VERIFIED。
  • 禁止为了“留痕完整”擅自创建不适用的 DECISIONS、TASKS 或 CHANGELOG。
  • 禁止在 record-init-env.sh 探测不到 model 时臆造 model 名;必须 --model 兜底或留 unknown 并标 INIT_ENV_NOT_VERIFIED。
  • 禁止手改 init-environment 受管区块里的表格行;append-only 由脚本负责。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning18d3 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    A comprehensive tool for legal professionals to manage and synchronize AI agent instructions (AGENTS.md and CLAUDE.md) across multiple platforms. It includes robust environment detection, automated content merging with managed blocks, and built-in privacy safeguards to prevent the inclusion of sensitive information.

  • Socket18d

    No alerts

  • Snyk18d

    Risk: MEDIUM · 1 issue

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week
Other metadata
metadata
{
  "version": "0.5.4",
  "author": "杨卫薪律师(微信ywxlaw)",
  "homepage": "https://github.com/cat-xierluo/legal-skills"
}

README badge

README badge for cat-xierluo/legal-skills/legal-harness-init