AGENTS.md · diff
git:20261013.e476078 to git:20261016.280e2bf
18 added, 1 removed. Audit A to A.
本项目旨在沉淀并分发面向律师办案的 Claude Skills，支持诉讼与非诉场景的 AI 协作。请所有 AI 代理遵循以下约定，确保技能可复用、可追溯、可扩展。
## 核心原则
- **中文优先**：**所有回复必须使用中文**，无论用户使用何种语言提问。这是强制要求，不是可选项。
- **技能导向**：每个技能独立成树（例：`med-extract/`），根目录直接包含 `SKILL.md`、`references/` 等资源和配套文档（`DECISIONS.md`、`TASKS.md`、`CHANGELOG.md`）。
- **文档即上下文**：关键决策、路线、任务、变更、日志必须记录在各技能目录下的对应文档文件中。
- **透明变更**：任何对用户或协作者有影响的修改都要写入对应技能目录下的 `CHANGELOG.md`，重要决策写入 `DECISIONS.md`。
- **技能级文档**：本项目的 `CHANGELOG.md`、`DECISIONS.md`、`TASKS.md` 等文档均为**技能级别**（位于各技能目录下），**不创建项目级别的文档**。当用户要求"更新文档"时，默认指当前操作涉及的特定技能的文档。
- **保留证据**：输出引用需可回溯到来源文件；缺失信息明确标注"未提及/待补充"，避免臆测。
+ ## 连续推进与阶段交接
+
+ 用户已授权实施时，在当前目标、写域和预算内连续推进；明确的只规划、只审计、冻结项及有界交回点继续有效。
+
+ 1. **角色与接续**：目标 PM 接回结果后继续父目标；Worker 完成工作包后交原 owner，不私领其他卡；只审计者返回裁定，不自获派发权。审计子请求的只读限制不撤销原 PM 已有的实施授权。
+ 2. **就绪即执行**：阶段完成、测试绿、提交、PR、审计通过或“已解锁可派”均不是单独停点。结束前核当前目标剩余项；授权、输入、依赖和资源齐备就当轮执行，或由有职责的 PM 派发并核回执，不停在下一步建议，不等用户说“继续”。
+ 3. **先自修再升级**：常规选择、可修失败和能力内的客观验证自行完成。“必须人工实测/验收”须有具体验收项、已尝试及真实缺口；可由 Agent 完成的先做，有争议交原上游复核，不把通信/工具缺口报成人工决策。
+ 4. **主动送审并消费**：到约定验收、返修复审或关键决策点，已有授权、已核上游和可用通道时，主动调用已安装的 `upstream-audit` 或既有机制；消费裁定、定向复验并续推。同候选无新证据不重审；每次只指定一个接续者，送达不明先查回执。
+ 5. **局部等待**：等审计、资源或人的取舍仅阻塞相关依赖，其他授权内独立项继续。真实人工项集中给问题、推荐/备选、可直接看的材料和影响；答复后按原授权恢复。
+ 6. **真实收口**：仅目标满足、角色交回点到达、无合法下一动作、用户暂停或实际预算/宿主限制时结束。未完成则简述剩余项、具体阻塞、下一 owner 和恢复条件；未收到结果不称通过，不为续跑扩范围或跳过门禁。
+ 7. **低成本等待**：优先原生等待/事件或程序观察，不为无变化周期唤醒模型。Goal 沿用户启用意图和宿主能力使用，不替代动作/验收或重置预算；无发送/唤醒通道则记“待运行时接续”，不虚报自动推进。
+
+ 具体步骤留在适用 Skill。启动与交接核实际工作树的规则入口；主目录更新不证明旧工作树或已有会话已重新加载。本文件不部署后台循环。
+
## 目录约定（每个技能项目）
- 根目录：`SKILL.md`（必填，含 frontmatter），`config/`、`references/`、`scripts/`、`assets/`（按需），文档文件（`DECISIONS.md`、`TASKS.md`、`CHANGELOG.md`），原始材料。
## 依赖管理规范
依赖说明应直接写在 `SKILL.md` 的"依赖"章节中。
### SKILL.md 依赖章节格式
```markdown
## 依赖
### 系统依赖
| 依赖 | 安装方式 |
|------|----------|
| 软件名 | macOS: `brew install xxx`<br>Linux: `sudo apt-get install xxx` |
### Python 包
| 包名 | 用途 | 安装命令 |
|------|------|----------|
| `package-name` | 用途说明 | `pip install package-name` |
```
### 依赖包文件（可选）
如需管理大量 Python 依赖，可在 `assets/` 或 `scripts/` 目录下使用 `requirements.txt`：
```bash
pip install -r scripts/requirements.txt
```
### 脚本依赖防护要求
**所有包含外部依赖的脚本必须做优雅降级处理**，确保用户未安装依赖时不会遇到晦涩的 `ImportError` 或 `ModuleNotFoundError`。
**规则**：
1. **硬依赖**（脚本核心功能所需）：用 try/except 包裹 import，捕获后输出清晰的安装提示并退出
2. **可选依赖**（增强功能所需）：用 try/except 包裹 import，设置 `HAS_XXX = False` 标志，在对应功能处降级处理
**示例 — 硬依赖**：
```python
try:
from docx import Document
from docx.shared import Pt, Cm
except ImportError:
print("❌ 缺少依赖: python-docx")
print(" 请运行: pip install python-docx")
print(" 或运行: pip install -r scripts/requirements.txt")
raise SystemExit(1)
```
**示例 — 可选依赖**：
```python
try:
from PIL import Image
HAS_PIL = True
except ImportError:
HAS_PIL = False
```
### SKILL.md 依赖声明要求
涉及脚本的技能，必须在 SKILL.md 中明确说明：
1. **哪些功能需要依赖**：区分"开箱即用"功能和"需安装依赖"功能
2. **安装方式**：提供一条命令即可完成安装（如 `pip install -r scripts/requirements.txt`）
3. **安装位置**：在用户首次需要运行脚本的位置（如"转换为 Word 文档"章节）给出安装说明，不要藏在文档末尾
## 许可证管理规范
### 技能许可证分类
1. **法律专业应用技能**：使用 CC BY-NC（署名-非商业性使用）
- 涉及法律业务分析、文书生成、专业咨询的技能
- 示例：`judgment-analysis`、`legal-proposal-generator`、`legal-text-format`、`legal-qa-extractor`
2. **通用工具类技能**：使用 MIT 许可证
- 内容获取、格式转换、开发工具等通用功能
- 示例：`mineru-ocr`、`local-asr`、`skill-manager`、`piclist-upload`、`course-generator` 等
3. **官方技能**：保持原有许可证不变
- `skill-creator`、`pdf`
### SKILL.md Frontmatter 许可证字段
- **法律专业应用**：`license: CC-BY-NC`
- **通用工具**：`license: MIT`
- **官方技能**：`license: Complete terms in LICENSE.txt`
### LICENSE.txt 文件
每个技能目录应包含对应的 LICENSE.txt 文件，使用完整许可证文本：
- CC BY-NC 许可证使用标准 Creative Commons Attribution-NonCommercial 4.0 International 文本
- MIT 许可证使用标准 MIT 许可证文本
### CC BY-NC 商用许可联系方式
使用 CC BY-NC 许可证的技能，LICENSE.txt 中的商用许可联系信息必须统一为：
```text
Commercial License
For commercial use licenses, please contact:
Email: secretxierluo@gmail.com
WeChat: ywxlaw (微信)
```
**注意**：创建或更新 CC BY-NC 技能时，必须确保 LICENSE.txt 中的联系方式与此规范一致。
### 版权信息规范
所有自研技能的 LICENSE.txt 文件必须使用统一的版权信息格式：
```text
Copyright (c) 2025 杨卫薪律师（微信ywxlaw）
```
**例外情况**：
- **官方技能**（skill-creator、pdf）：保持原作者版权信息
- **协作技能**：如 mineru-ocr、local-asr 等基于外部项目的技能，可保留项目特定的版权信息（如 "MinerU Skill Contributors"）
### README.md 许可证列
在 README.md 技能列表表格中应包含"许可证"列，明确标注各技能的许可证类型。
### README.md 最近更新区维护
根目录 README.md 顶部的"最近更新的 Skill"用于展示公开 Skill 的项目动态。新增 Skill、从 `test/` 正式迁移 Skill、或更新 Skill 版本时，必须同步维护该区域：
- 只保留最近 8 条公开 Skill 动态，不纳入 `private-skills/` 或 `custom-skills/`
- 按各技能 `CHANGELOG.md` 最新版本日期倒序排列
- 类型统一使用 `新上传`、`正式发布`、`更新`
- 更新要点必须来自对应 Skill 的 `CHANGELOG.md`，不得臆测
- 不创建项目级 `CHANGELOG.md`，继续遵守技能级文档规则
## 文件夹存放规范（主项目）
- 正式发布的技能放在 `skills/` 目录下（如 `skills/pdf/`），调试中的技能放在 `test/` 目录下。
- 技能目录名与技能 name 保持一致。
- 示例/原始材料与技能同级放置，命名清晰，避免混入其他技能资料。
## 标准作业流程（每个技能）
- 1) **选择目标**：阅读 `TASKS.md`，选择首个未完成目标作为当前任务。若无目标，补充并认领。
+ 1) **选择目标**：阅读对应技能的完整任务卡，优先接续当前进行中项，再选当前授权目标内已就绪的高优先级项；不把受阻或仅有标题的未完成项当作可执行任务。用户明确指定任务时优先处理；当前目标无可执行项时说明原因，不为保持运行自行扩展范围。
2) **分析与计划**：理解目标输出与验收标准；必要时内部规划步骤。
3) **执行与决策记录**：
- 代码/文档修改同步在对应技能目录下完成。
- 涉及重要取舍或涌现任务，写入 `DECISIONS.md`（说明背景、方案、理由）。
4) **更新文档**：
- 变更：`CHANGELOG.md` 按类别记录。
- 任务：完成项在 `TASKS.md` 勾选，新增子任务时及时登记。
+ 5) **核验与接续**：按本轮约定核真实结果并写回任务源；遵循上文“连续推进与阶段交接”，已就绪的下一动作当轮执行或交回具名接续者，不停在阶段总结。
+
## 写作与输出要求
- SKILL.md 使用祈使/不定式语气，明确何时触发、如何操作。
- 引用具体文件请使用相对路径（示例：`med-extract/SKILL.md`），避免粘贴大段内容。
- 发现矛盾或缺失要显式提示（如"缺少出院时间，需补充"）。
### CHANGELOG.md 格式规范
- **版本号规则**：
- 测试版本（`test/` 目录）：使用 `0.x.x` 版本号
- 正式版本（根目录）：使用 `1.x.x` 版本号
- 禁止使用 `Unreleased` 作为版本号
- **版本记录格式**：
```markdown
## [版本号] - YYYY-MM-DD
### 新增
- 新功能描述
### 改进
- 优化内容描述
### 技术优化
- 技术改进描述
### 待办事项
- 后续计划描述
```
- **分类标签**：使用 `新增`、`改进`、`修复`、`技术优化`、`文档完善` 等分类
- **内容要求**：明确说明变更的性质、影响和原因，避免模糊描述
- **文件格式**：确保文件以单个换行符结尾
### 迁移类 Skill 的版本历史保留规范
当 Skill 从现有 Command 或提示词迁移而来时，应保留原有版本历史以支持完整追溯：
- **保留场景**：Skill 从 `/illustrate`、`/extract-course` 等 Command 转换，或从其他已维护的提示词迁移而来
- **保留要求**：
- 在 CHANGELOG 底部添加「原始版本记录（Command 时期）」或类似章节
- 保留完整的版本迭代历史，从 v1.0 到迁移前的最后一个版本
- 每个版本记录日期和变更摘要，确保历史可追溯
- **格式示例**：
```markdown
## 原始版本记录（Command 时期）
### v3.0.3 (2025-12-28)
- 强化逻辑性动态效果优先：明确箭头绘制动画和虚线框流动动画为最高优先级
### v3.0 (2025-12-28)
- 重大升级：引入动态 SVG 效果，支持角色浮动动画、虚线框流动、指向性线条动画等
### v1.0 (2025-10-27)
- 初版命令框架，确立基本设计原则和流程
```
- **版本号延续**：Skill 的正式版本从 v1.0.0 开始，不延续原始 Command 的版本号
- **价值说明**：保留原始版本历史有助于理解功能演进脉络、设计决策依据和潜在问题追溯
## Skill 开发指南
Skill 开发与合规规范以 [skills/skill-lint](./skills/skill-lint/) 为唯一维护源：目录结构、Frontmatter 元数据、Progressive Disclosure、编排协作等细则见其 `references/`（如 `skill-dev-guide.md`、`skill-orchestration-guide.md`）。交付前以 skill-lint 审计结果为准，不另维护 docs/ 下的开发指南副本。
## 多技能协作
- 新增技能：使用 Skill Creator 初始化后，按上述目录约定补齐文档文件。
- 避免跨技能污染：只修改当前技能树内文件，除非明确需要共享资源。
## 安全与合规
- 避免编造事实；无法确认的信息标记"未提及/待补充"。
- 如处理未脱敏材料，提醒用户审查隐私与合规。
- 不执行破坏性命令（如 `git reset --hard`），保持用户未提交的更改。
## 敏感信息安全规范
### 核心原则
**敏感信息（API Key、Token、密码、凭证）绝对不可提交到 Git**。无论是否有意，一经发现必须立即处理。
### 敏感文件类型
| 文件类型 | 示例 | 处理方式 |
|----------|------|----------|
| 环境变量文件 | `.env`, `.env.local`, `.env.production` | 必须加入 `.gitignore` |
| 配置文件 | `config/secrets.yaml`, `config/credentials.json` | 使用 `.example` 模板 |
| 密钥文件 | `*.pem`, `*.key`, `*.p12` | 永不提交 |
| 令牌文件 | `token.txt`, `access_token` | 永不提交 |
### Skill 开发安全检查清单
创建或修改 Skill 时，AI 必须执行以下检查：
1. **新增依赖检查**
- 如果 Skill 需要 API Key，必须同时创建 `.env.example` 模板文件
- 在 SKILL.md 中说明如何配置环境变量
2. **提交前检查**
- 运行 `git status` 和 `git diff` 审查所有变更
- 检查新增文件中是否包含 `API_KEY`、`TOKEN`、`SECRET`、`PASSWORD`、`KEY` 等关键词
- 确认 `.gitignore` 已覆盖新增的敏感文件类型
3. **GitHub 风险警示**
- 通过 PR 提交敏感信息风险更高：PR 的 diff 快照会永久保存，即使删除分支也无法清除
- 如误提交敏感信息，必须：撤销泄露的 API Key + 联系 GitHub 支持删除 + 重写历史
### .gitignore 维护
- 项目根目录 `.gitignore` 使用 `**/.env` 通配所有目录
- 新增 Skill 时，如使用非标准配置文件，应检查并更新 `.gitignore`
- 示例模板：
```bash
# 敏感配置
**/.env
**/config/secrets.*
**/credentials.json
```
### 泄露应急响应
如发现敏感信息已提交：
1. **立即撤销**：前往对应平台（MiniMax、OpenAI 等）撤销泄露的 Key
2. **重写历史**：使用 `git filter-repo` 删除敏感文件并强制推送
3. **联系支持**：如通过 PR 泄露，联系 GitHub 支持请求删除
4. **检查 forks**：提醒用户检查是否有 fork 保留了旧历史
## Monorepo 合并规范
本项目的 Monorepo 仓库（如 private-skills、legal-skills）中，每个子目录是独立 Skill。
所有 Agent 的开发、修改、测试和提交在独立 worktree 中完成；主目录固定 main，只作稳定加载入口和具名集成者的串行采用目标。已有主目录身份异常时保留现场，不自行 checkout/switch 回 main。此项按 2026-10-06 用户最新要求执行，替代旧的主目录开发与目录 checkout 示例。
集成前固定候选 OID、允许路径、当前主目录 HEAD、index 和 dirty；逐文件对账，保留本机较新成果与其他会话改动。主目录有并发漂移或同一路径在途写入时停止该次采用。禁止以 checkout/pull/reset/整分支合并或旧整目录复制修复主目录。更新路径与验证方法统一读取 [git-workflow 主目录合同](skills/git-workflow/references/main-directory-protection.md) 和 [改动集成](skills/git-workflow/references/change-integration.md)，不在本规范复制命令。
单 Skill/套件从创建开始按 [稀疏工作树](skills/git-workflow/references/sparse-worktree.md) 检出目标及必要依赖。主目录安装入口不指向临时开发分支；Skill 稳定快照或具名采用后的 main 才作为共享加载源。
## ClawHub 发布适配
如需将 Skill 发布到 ClawHub，SKILL.md frontmatter 需包含以下字段：
### 必填字段
| 字段 | 来源 | 说明 |
|------|------|------|
| `name` | 目录名 | 与目录名保持一致 |
| `description` | 现有字段 | 技能的简洁描述 |
### 推荐字段（可维护性）
| 字段 | 来源 | 说明 |
|------|------|------|
| `version` | CHANGELOG | ClawHub 使用此字段而非 CHANGELOG，建议从最新版本号提取 |
| `homepage` | 固定值 | 项目主页，`source` 可省略 |
### 完整示例
```yaml
---
name: <skill-name>
description: <描述>
version: "<x.y.z>"
license: <许可证>
author: 杨卫薪律师（微信ywxlaw）
homepage: https://github.com/cat-xierluo/legal-skills
---
```
**同步工具**：使用 [skill-publish-sync](./skills/skill-publish-sync/SKILL.md) 技能批量同步到 ClawHub。
## AGENTS.md 更新规范
**重要**：本规范文件（AGENTS.md）的每次修改都必须同步更新底部的"变更历史"章节。
### 更新流程
1. **修改内容**：在 AGENTS.md 中进行任何修改（新增/修改规范、调整格式等）
2. **更新变更历史**：在"变更历史"表格顶部添加新的版本记录
3. **版本号递增**：根据修改性质递增版本号
### 版本号规则
遵循相同的 CHANGELOG.md 规范：
- **小修改**（格式调整、文字优化）：递增最后一位（如 v1.1.5 → v1.1.6）
- **新增规范**：递增中间一位（如 v1.1.5 → v1.2.0）
- **重大变更**：递增第一位（如 v1.1.5 → v2.0.0）
### 变更历史记录格式
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v1.1.6 | YYYY-MM-DD | 简要描述本次修改的内容 |
**示例**：
```markdown
| 版本 | 日期 | 更新内容 |
| :----- | :--------- | :------------------------------------------------------- |
| v1.1.6 | 2026-01-23 | 新增 AGENTS.md 更新规范：要求每次修改 AGENTS.md 时同步更新变更历史 |
```
### 自动更新要求
AI 代理在修改 AGENTS.md 时，必须：
1. 检查是否对文件内容进行了实质性修改
2. 如果是，自动在"变更历史"表格顶部添加新记录
3. 递增版本号
## 变更历史
| 版本 | 日期 | 更新内容 |
| :----- | :--------- | :------------------------------------------------------------------------------------------------------------------------------------ |
+ | v1.10.0 | 2026-10-16 | 新增连续推进与阶段交接默认：明确 PM/Worker/审计者职责、主动送审、局部等待与真实停止条件；优先程序观察，修正任务选择和CLAUDE导入语法，并提示旧会话规则重载边界 |
| v1.9.4 | 2026-10-13 | 许可证示例技能名随 `litigation-analysis` 更名为 `judgment-analysis` 同步更新（v2.0.0） |
| v1.9.3 | 2026-10-06 | 所有 Agent 开发改用独立 worktree；主目录固定 main、具名串行采用；删除主目录 checkout/pull 及整目录覆盖示例 |
| v1.9.2 | 2026-09-23 | Skill 开发规范唯一维护源改为 skill-lint（细则在其 references/），删除 docs/ 下已内化的 8 份开发/协作指南文档 |
| v1.9.1 | 2026-09-23 | 将通用工具及协作技能示例由旧名 funasr-transcribe 更新为 local-asr |
| v1.9.0 | 2026-08-09 | 停用 Cloud Plugin Marketplace，删除 `.claude-plugin/marketplace.json` 与 `plugin.json` 及对应配置规范；公开 Skill 以 `skills/` 为交付源，发布索引由 README 与实际启用渠道维护 |
| v1.8.1 | 2026-05-20 | 修正 Skill 开发指南链接，明确后续 Skill 规范以 docs/SKILL-DEV-GUIDE.md 为准 |
| v1.8.0 | 2026-05-17 | 新增 README 最近更新区维护规范：要求新增、正式发布或更新公开 Skill 时同步维护根 README 动态 |
| v1.7.4 | 2026-05-15 | 新增通用 Monorepo 合并规范：禁止 git merge 直接合并，改用目录级 checkout |
| v1.7.3 | 2026-05-14 | 统一私有 Skill 与 Customer Skill 的私有仓库和忽略规则说明 |
| v1.7.2 | 2026-05-14 | 明确 custom-skills 与 private-skills 一样为独立私有 Git 仓库，不公开 |
| v1.7.1 | 2026-05-14 | 精简 custom-skills 本地目录说明：与 private-skills 合并说明，移除业务服务场景表述 |
| v1.7.0 | 2026-05-14 | 新增 custom-skills 本地目录规范：按二级项目文件夹组织，项目 Skill 放入项目内 skills/ |
| v1.6.0 | 2026-04-11 | 强化依赖管理规范：新增"脚本依赖防护要求"（硬依赖 try/except + 安装提示、可选依赖降级标志）、"SKILL.md 依赖声明要求"（区分开箱即用/需安装功能、安装位置就近原则） |
| v1.5.5 | 2026-03-24 | 新增 CC BY-NC 商用许可联系方式规范，统一联系方式 |
| v1.5.4 | 2026-03-21 | 精简 SKILL.md frontmatter：删除 23 个技能的 source 字段，只保留 homepage（符合 ClawHub 规范：source/homepage 二选一） |
| v1.5.3 | 2026-03-21 | 重构 ClawHub 同步指南：删除 CLAWHUB.md，创建 clawhub-sync skill 替代，提供交互式批量同步能力 |
| v1.5.2 | 2026-03-21 | 完善 SKILL.md frontmatter 和 CHANGELOG 格式：为 5 个技能添加 license 字段，修复 3 个技能的 CHANGELOG 版本格式（douyin-batch-download、de-ai-polish、svg-article-illustrator） |
| v1.5.1 | 2026-03-20 | 精简 ClawHub 发布适配章节：区分必填字段（name、description）与推荐字段（version、homepage），移除已删除脚本引用 |
| v1.5.0 | 2026-03-20 | 新增 ClawHub 发布适配章节：定义 frontmatter 字段要求 |
| v1.4.0 | 2026-02-18 | 新增敏感信息安全规范：定义敏感文件类型、Skill 开发安全检查清单、.gitignore 维护要求和泄露应急响应流程 |
| v1.3.5 | 2026-02-13 | 新增"技能级文档"原则：明确 CHANGELOG.md 等文档为技能级别（位于各技能目录下），不创建项目级别文档；用户要求"更新文档"时默认指当前技能的文档 |
| v1.3.4 | 2026-02-08 | 新增版权信息规范：统一所有自研技能 LICENSE.txt 的版权信息为"杨卫薪律师（微信ywxlaw）"，并更新 4 个技能的 LICENSE.txt 文件 |
| v1.3.3 | 2026-02-08 | 更新许可证管理规范：将法律专业应用技能的许可证从 Apache-2.0-NC 更改为 CC BY-NC（署名-非商业性使用-相同方式共享），更新相关文档和模板 |
| v1.3.2 | 2026-02-08 | 新增许可证管理规范：定义技能许可证分类（法律专业应用使用 Apache-2.0-NC、通用工具使用 MIT）、SKILL.md frontmatter 许可证字段、LICENSE.txt 文件要求和 README.md 许可证列 |
| v1.3.1 | 2026-02-07 | 新增迁移类 Skill 版本历史保留规范：要求从 Command 或提示词迁移的 Skill 在 CHANGELOG 中保留原始版本历史，确保功能演进可追溯 |
| v1.3.0 | 2026-01-30 | 重构文档结构:将 Skill 开发相关内容分离到独立的 SKILL-GUIDE.md 文件,AGENTS.md 聚焦项目协作规范;通过引用链接两个文档 |
| v1.2.0 | 2026-01-30 | 重新设计 Progressive Disclosure 层级:基于官方加载机制,将三级系统扩展为四级(Level 0: Frontmatter, Level 1: 核心文档, Level 2: 支持性文档, Level 3: 可执行资源);新增"文档编写最佳实践"章节;修正技能目录位置说明(`skills/` 目录);优化依赖管理说明,删除反向约束 |
| v1.1.6 | 2026-01-23 | 新增 AGENTS.md 更新规范：要求每次修改 AGENTS.md 时必须同步更新底部的"变更历史"章节；定义版本号递增规则和自动更新要求 |
| v1.1.5 | 2026-01-23 | 新增 Skill 文档规范：基于官方 Claude Code skills 格式，定义 SKILL.md frontmatter 元数据、description 写作规范、依赖说明格式和 Progressive Disclosure 设计原则 |
| v1.1.4 | 2026-01-22 | 简化依赖管理规范：依赖说明直接写在 SKILL.md 中 |
| v1.1.3 | 2026-01-21 | 强化中文回复要求：将"中文优先"提升为核心原则首位，明确为强制要求而非可选项 |
| v1.1.2 | 2026-01-07 | 新增 `CHANGELOG.md` 格式规范：定义版本号规则（测试版 0.x.x、正式版 1.x.x）、版本记录格式、分类标签和内容要求 |
| v1.1.1 | 2026-01-07 | 将 `config/` 纳入按需目录，支持需要配置文件的技能（如 API Token）；配置 archive/ 目录的 git 策略（忽略内容但保留目录） |
| v1.1.0 | 2026-01-07 | 精简文档结构：删除冗余的 `ROADMAP.md` 和 `JOURNAL.md`，保留核心文档 `DECISIONS.md`、`TASKS.md`、`CHANGELOG.md` |
| v1.0.0 | 2026-01-07 | 初始版本，定义法律技能项目的核心协作规范：技能导向、文档即上下文、透明变更、目录约定、标准作业流程及安全合规要求 |
## 私有目录说明（仅本地生效）
私有 Skill（`private-skills/`）与 Customer Skill（`custom-skills/`）均为本地私有符号链接目录，指向独立私有 Git 仓库（不公开），不作为公开发布目录；公开发布的正式技能以 `skills/` 为交付源，README 与实际启用的发布渠道维护索引。
- `private-skills/` 指向 `../private-skills`
- `custom-skills/` 指向 `../custom-skills`，按二级项目文件夹组织，项目相关 Skill 放在该项目文件夹内的 `skills/` 目录
- 两类私有仓库的忽略规则保持一致，在各自实际仓库的 `.gitignore` 中维护
- 避免在 legal-skills 仓库中提交这两个目录的内容；需要做 Git 操作时，在符号链接指向的实际目录执行