Agents Power

---
name: agents-power
description: "统一评估、初始化和更新当前仓库的 AGENTS.md。用户提到 $agents-power，或要求“评估 AGENTS.md”“检查指引漂移”“生成/更新 AGENTS.md”“先评估再修改”时使用。默认先评估：AGENTS.md 存在时走 audit-only，不存在时走 audit-then-apply。"
---

# Agents Power（中文版）

统一处理 `AGENTS.md` 的评估与落地修改，确保规则与仓库事实一致、输出简洁可执行。

规则来源按以下优先级处理：现有 `AGENTS.md`、`CONTRIBUTING` 等仓库明示规则 > CI 与项目配置 > 具有代表性的近期 Git 历史。历史风格不一致、存在畸形提交或证据不足时，只记录现象，不将其推导为硬规则，也不得覆盖更高优先级的现有规则。

## 模式判定
- `audit-only`：用户仅要求评估、检查漂移、给建议时使用；不改文件。
- `apply`：用户明确要求生成或更新 `AGENTS.md` 时使用；允许改文件。
- `audit-then-apply`：用户要求“先评估再修改”时使用。
- 若用户未明确指定模式：`AGENTS.md` 存在时默认 `audit-only`；`AGENTS.md` 不存在时默认 `audit-then-apply`。

## 核心流程
1. 读取 `references/workflow.md`，先执行最小探测。
2. 按探测结果分支处理（空目录、非 Git、存在构建文件等），仅提取可验证事实。
3. 根据模式输出评估结果，或进入生成/更新流程。
4. 仅在 `apply`/`audit-then-apply` 模式下读取 `assets/AGENTS.zh.template.md` 起草内容。
5. 写入前读取 `references/quality-checklist.md` 完成自检。
6. 输出结论与变更点；未明确要求时不自动提交。

## 执行规则
- 优先最小必要改动，避免无关重构。
- 默认中文沟通；回复简洁、可执行。
- 不提供时间预估或时间承诺。
- 探测仓库时优先遵守 `.gitignore`，并默认忽略临时目录（如 `.agents/`、`temp/`、`tmp/`、`.tmp/`）。
- 命令需在“空目录/非 Git 仓库”场景下可安全降级，不因单点失败中断任务。
- 内容必须基于仓库事实，不做臆测。

## Audit 输出格式
使用以下紧凑模板：

```md
结论: 需要更新 / 暂不需要更新

建议尽快改
1. ...
2. ...

可选补充
1. ...
2. ...

无需改动
- ...
```

每条建议应包含：`AGENTS.md` 位置、变更原因、1-2 行最小修改方向。

## Apply 输出必备章节
确保最终 `AGENTS.md` 有清晰标题，并按仓库事实覆盖以下内容：
- 协作偏好、项目结构、构建/测试命令、编码约定。
- 测试与开发策略、提交与 PR 规则。
- 仅在仓库有明确证据时，写入 TDD、文档语言策略、安全约束等专项规则。
- 不生成「变更检查清单」这类末尾汇总章节：若其每一条都能在前文找到，属于重复，应删除。

## 篇幅与分层
- 根 `AGENTS.md` 控制在 200 行以内。它每轮会话整份进上下文，重复内容会稀释重点。
- 超出时优先拆分而非删减：只在某目录生效的规则移到该目录的 `AGENTS.md`（就近者优先，规范原生支持），根文件留一行指针。
- 已存在嵌套 `AGENTS.md` 时，audit 须一并读取，不要把子目录规则当作根文件缺失重新写回。
- 不要把 `AGENTS.md` 放进被静态站点当作页面源的目录（如本仓库的 `docs/`，VitePress 会把它构建成页面）。

## 兜底处理
- 缺少关键证据（如无构建脚本、无测试框架）时，在 `AGENTS.md` 中明确写明。
- 非 Git 仓库时跳过 `git log`，并明确说明无法提取提交风格。
- 最终输出不得保留模板占位符。
- 若按忽略规则过滤后当前目录为空，直接基于模板生成最小可用 `AGENTS.md`。