/legal-harness-init

15 - 与 project-init 的互补边界

一句话结论

project-init 做项目脚手架（skills、settings、docs 体系），本 skill 做法律人专属配置（用户级 + 项目级 AGENTS.md）。两者互补不互替，检测互不重复。

职责对照

协作点

已跑过 project-init 的项目：

本 skill 的 detect.sh 只有同时检测到 .claude/skills/、项目指令文件和至少一个脚手架证据（如 .claude/settings.json、.codex/skills 或 docs/）才判定已跑过 project-init；仅有通用 docs/ 不算。

此时本 skill 只用稳定 marker upsert 项目级法律区块：

• upsert 法律安全、回溯契约和受控上下文入口等受管区块
• 不重写已有部分（项目协议、SOP 等）
• 不覆盖 marker 之外的项目协议；跨平台共享时可用 @include

未跑过 project-init 的项目：

本 skill 主动提示：

检测到当前项目未运行过 `project-init`。建议：

1. 先跑 `project-init`：初始化项目脚手架（skills、settings、docs 体系）
2. 再跑本 skill：补法律安全、回溯和受控上下文规则

也可以只跑本 skill，但缺少 `project-init` 的脚手架，后续 `docs/`、`settings.json`、`.gitignore` 需要手动维护。

不强制——用户可选择"先跑本 skill 再补 project-init"或"两个都跑"。

用户级与项目级的协作

project-init 只做项目级，不做用户级。本 skill 同时做两层：

• 用户级（一次性、跨项目稳定）：本 skill 独占
• 项目级（每个项目不同）：本 skill 与 project-init 协作

用户级 M1-M5 完全独立，不依赖 project-init。 项目级 M6-M8 + M5 细化依赖 project-init 创建的目录结构（如果跑过）。

检测逻辑

scripts/detect.sh 检测项目级 AGENTS.md 和 project-init 痕迹：

# 示意：实际逻辑见 scripts/detect.sh
# .claude/skills + (AGENTS.md 或 CLAUDE.md) + (settings/.codex/skills/docs)

返回结构化 JSON 后，agent 决定：

• 已跑过 → 只 upsert 法律安全、回溯和受控上下文入口
• 未跑过 → 提示用户先跑 project-init

写入策略

已跑过 project-init：

项目级 AGENTS.md 现状（project-init 生成的）：
- 项目协议
- SOP
- ...

本 skill 用受管区块增量写入：
---

# 法律安全基线

（权限、保密、溯源、人工裁决）

# 受控上下文入口

（项目代号、阶段、事实载体和读取条件）

# 回溯契约

（M5 用户级 + 项目级细化）

未跑过 project-init（用户选择直接用本 skill）：

项目级 AGENTS.md（本 skill 生成的最小基线）：
- 法律安全基线（M4）
- 角色、工作流与协作偏好（M1-M3，按层级放置）
- 回溯契约（M5 用户级 + 项目级细化）
- 项目上下文（M6）
- 受控事实入口（M7，不复制真实案件材料）
- 文件结构（M8）
- 项目级回溯补充（M5 细化）

顺序建议

1. 第一次使用本 skill：先做用户级（M1-M5）
2. 新项目开工：
   a. 先跑 `project-init`（如果有项目脚手架需求）
   b. 再跑本 skill 项目级（M6-M8 + M5 细化）

不强制，但这个顺序最舒服：用户级一次性配好跨项目稳定部分；每个新项目用 project-init 起步 + 本 skill 补法律人专属。

与其他 skill 的关系

接下来读什么

• 完整参考范例（5 类律师的 AGENTS.md 写法）→ references/17-examples/
• FAQ（含错误处理、跨平台同步冲突）→ references/16-faq.md