用途
suggest-agent-rules 是一个面向编码智能体的技能，目标是设计「该仓库专用的 Coding Agent 规则」。它不产出泛泛而谈的通用建议，而是基于会话历史与仓库实际情况，提出务实、可验证的规则，让智能体在后续工作中减少犹豫、提升质量。
主要能力
- 访问并分析智能体会话历史，支持 Claude Code 与 Codex CLI 两种来源。
- 提供三个工具脚本：list-sessions.sh 获取会话列表、analyze-session.sh 详细分析单个会话、extract-patterns.sh 从多个会话中提取模式。
- 从会话中提取用户的明确指示与偏好、反复出现的手工返工、常用工具与文件、错误模式。
- 结合当前仓库内容（README、CONTRIBUTING、目录结构、配置文件、CI 设置、测试结构）与本地 Git 历史、GitHub 历史（PR/Issue/评审评论）进行综合判断。
- 输出结构化规则，每条规则包含优先级、行动指令、依据、验证方法、适用范围与置信度。
使用方式
该技能在以下时机使用：初次上手时、评审意见增多时、重构或大规模迁移前、CI 或运维规则变化时。
执行流程按固定顺序进行：
- 把握仓库概览，推断主要语言、框架、构建工具与包管理器，优先查看根目录及 README、CONTRIBUTING、CODEOWNERS、Makefile、package.json、pyproject.toml、go.mod、Cargo.toml、.github/workflows 等文件。若已有规则或编码规范，优先尊重，不重复造规则。
- 提取失败与返工模式，从会话历史中找出反复被提醒的点与偏好，从 Git/PR/评审中找出同类意见多次出现的领域。
- 将面向人的规范翻译为智能体可执行的行为（Do/Don't），并分类为安全、变更方针、质量、仓库惯例、PR 运用。
- 对规则进行优先级排序：Must（违反会导致事故或大幅返工）、Should（影响质量或速度）、Could（有余力时执行）。
输出格式严格遵循四段：A. 仓库前提（简短）；B. 观察到的趋势（最多 10 条，区分会话历史、Git、PR 评审来源）；C. 建议规则（最多 12 条，按优先级排列，每条含 Rule、Why (evidence)、Verify、Scope、Confidence）；D. 可直接粘贴的最终规则正文，以 Do/Don't 为主，不含多余说明。
适用场景
- 为特定仓库建立智能体工作规则。
- 在评审意见增多或返工频繁时，定位并固化改进点。
- 重构或大规模迁移前，明确变更边界与安全约束。
- CI 或运维规则变化后，同步更新智能体行为准则。
限制
- 不得断定仓库中无法确认的命令或规范，例如不推荐不存在的 npm test。
- 必须包含破坏性操作（reset、force push、大量删除、迁移应用等）的事前确认规则。
- 不得输出秘密信息（密钥、令牌、客户信息），粘贴日志或配置值时需脱敏。
- 规则数量不宜过多，最多 12 条，必要时以「次选规则（Optional）」另列。
- 会话文件路径与格式：Claude Code 位于 ~/.claude/projects/<project-path-encoded>/<UUID>.jsonl；Codex CLI 位于 ~/.codex/sessions/YYYY/MM/DD/rollout-<datetime>-<UUID>.jsonl。项目路径编码示例：/Users/username/projects/myapp → -Users-username-projects-myapp。
- 会话数据结构细节参见 references/session-structure.md，其中 Claude Code 通过 parentUuid/uuid 构建对话树，type 字段区分 user/assistant，message.content 包含 thinking、text、tool_use、tool_result 块，子智能体保存在 <session-uuid>/subagents/agent-<id>.jsonl，isSidechain 为 true。
- 若 gh 不可用，则仅基于本地可获取范围（如 git log）推断，并明确标注不确定性。