AGENTS.md · diff
git:20261016.1f942c5 to git:20261016.c4c878c
3 added, 2 removed. Audit A to A.
# legal-skills Agent 协作指引
使用中文回复。本仓库维护法律与通用工具 Skill;本文件规定共同工作行为,产物规范按下方路由按需读取,不一次加载全部参考。
## 项目与任务上下文
- 公开 Skill 在 `skills/`,试验在 `test/`。`private-skills/` → `../private-skills`、`custom-skills/` → `../custom-skills` 是本地独立私仓链接,Git 操作在实际仓库执行,不将其内容提交到公仓;custom-skills 按项目分组,项目内再放 `skills/`。
- 先读当前目标 Skill 的完整任务卡与适用规则;用户最新指令优先。接续进行中项,再选当前授权目标内已就绪的高优先级项,不凭标题开工或为续跑扩展目标。
- 任务、执行证据、重要决定和用户可见变更分别写回该 Skill 的既有 `TASKS.md`、`DECISIONS.md`、`CHANGELOG.md`;不创建项目级任务库/变更流水,不为形式补无关文档。事实只留一个权威来源,其余引用。
- 修改当前目标及具名依赖,保留其他会话的材料和归属。完成结论依据真实结果;缺失、未验、受阻说明具体范围、下一责任方与恢复条件。
## 角色、推进与交回
共享此文件不代表共享角色。按本轮用户指令和具名任务确定负责目标、可做动作、交回对象及唯一接续者;明确的信息直接复用,不按模型、harness、“上游/下游”或历史身份推断权限。
1. **角色边界**:PM 接回结果后继续父目标;Worker 完成有界工作包后交原 owner;只审计者返回裁定。子审计的只读限制不冻结父 PM;当前会话明确只规划/只审计时,按本轮边界交回。
2. **就绪即执行**:授权、输入、依赖和资源齐备就当轮实施或派发并核回执。阶段总结、测试绿、提交、审计接受和“可派/可合并”不是单独停点;由原授权执行者完成交付、核真实回执并接续,不等待用户说“继续”。
3. **自修与送审**:常规选择、可修失败和能力内验证自行完成;到约定验收/复审/关键决策点,向已核上游主动送审、消费裁定并定向复验。同候选无新事实不重审;送达未知先查原回执,不重复派工。
4. **局部等待与人**:先核“必须人工”的实际缺口,能由 Agent 做的先做。保留用户明确要求的方向/偏好/接受门,集中给推荐、备选、可直接看的材料及影响;只挂起相关依赖,独立项继续,答复后按原授权恢复。
5. **真实终点**:仅目标满足、角色交回点到达、无合法下一动作、用户暂停或真实预算/宿主限制时结束。Goal 沿用户启用意图和宿主能力使用,不代替动作/验收、不重置预算;优先原生等待/事件或程序观察,不为无变化周期唤醒模型;无唤醒通道明确记待运行时接续。
交接核实际规则/Skill 版本、任务和候选身份;主目录更新不证明旧工作树或已有会话已重载。审计接受、合并、实际加载和用户接受分别按原任务要求核实,审计建议不增加操作权限。
## 开发隔离与采用
开发、编辑、测试和提交使用具名单 writer 的独立 worktree;主目录固定 `main`,仅作稳定加载和具名串行采用。Skill 从创建时稀疏检出目标及核实依赖。采用保留当前 HEAD/index/dirty 和他人在途材料,发现漂移先对账;具体操作读取 git-workflow,不在主目录切分支、pull/reset/stash 或整目录覆盖。
## 按需读取
| 当前工作 | 权威入口 |
|---|---|
| 创建/修改 Skill,检查正文、依赖、脚本、结构与输出 | 使用已安装的 `skill-creator`;规范/验收读 [skill-lint](skills/skill-lint/SKILL.md),按其索引选模块 |
- | 本仓公开 Skill 的许可、版权、版本、README 与发布字段 | [legal-skills 项目发布配置](skills/skill-lint/references/legal-skills-project-profile.md),通用发布检查由 skill-lint 维护 |
+ | 本仓公开 Skill 的许可、版权、版本、README 与发布字段 | [legal-skills 项目发布配置](docs/agent-guides/legal-skills-project-profile.md),通用发布检查由 skill-lint 维护 |
| Git/worktree/PR/合并/稳定采用 | [git-workflow](skills/git-workflow/SKILL.md);敏感信息与提交隐私直接读其[隐私预检](skills/git-workflow/references/privacy-preflight.md),泄露处置按其历史撤回流程及原授权 |
| 上游审计与合并裁定、下游执行交接 | 已安装的 `upstream-audit`;实际派发使用当前已授权执行器,按原任务绑定唯一接续者 |
| 公开平台同步 | [skill-publish-sync](skills/skill-publish-sync/SKILL.md),按目标平台现行合同与已有授权执行 |
所需入口不可用时指出具体缺口,保留可独立执行部分,不伪造已加载或另造未经核实的替代流程。
## 变更历史
修改本文件时同步记录版本与实际变化;旧历史仅在溯源时读取。
| 版本 | 日期 | 更新内容 |
|---|---|---|
+ | v2.0.1 | 2026-10-16 | 项目发布配置与旧历史迁至docs/agent-guides;通用skill-lint只维护通用审查规则 |
| v2.0.0 | 2026-10-16 | 聚焦任务、角色与交接行为;产物规范按需转引Skill,项目发布配置及旧历史移入skill-lint参考,保留工作树隔离与真实完成边界 |
- [v1.11.0及以前的完整记录](skills/skill-lint/references/legal-skills-agents-history.md)。
+ [v1.11.0及以前的完整记录](docs/agent-guides/legal-skills-agents-history.md)。