仓库规则提炼

你要解决的问题

• 仓库里的规则散落各处：README、CONTRIBUTING、.cursor 规则文件、聊天记录，智能体改代码时根本不知道这些约束的存在，经常做出违反约定的改动。
• 团队踩过的坑没有沉淀：某个接口不能删、某条流水线顺序不能乱，这类隐性知识要么在对话里丢失，要么从未被写下来。
• 规则文档膨胀后难以维护：把所有约定塞进一个 CLAUDE.md，文件越来越长，智能体读不全、抓不住重点。

它如何工作（核心能力与关键步骤）

• 核心思路：把规则从静态文档变成可路由的技能目录。每个技能对应一个具体工作场景或子系统，智能体在动手前先检索相关技能，再决定怎么做。
• 关键步骤：

- 盘点现有文档：CLAUDE.md、.cursor/rules/workflow.mdc，找出重复和分散的内容。
- 按场景拆分：把大而全的规则按任务类型或子系统切成多个技能文件。
- 建立目录结构：每个技能一个目录，内含该场景下的约束、步骤和注意事项。
- 让智能体可路由：变更前先检索相关技能，而不是盲目改动。

• 从简单起步：初始只需一份纯文本的 CLAUDE.md 或 .cursor/rules/workflow.mdc；内容开始臃肿时，再按 WORKFLOW.md 的 Quick Start 路径升级为技能目录。
• 这是一个元技能：管理的是「如何把规则组织成技能」这套方法论，而不是某一份具体的规则文件。

适用边界与注意点

• 前置条件：仓库里需已有项目文档，否则提炼无从谈起；智能体环境要能读取或输出技能目录。
• 不要一步到位：从最小可用文档起步，等规则确实变多再拆，避免过早设计。
• 技能不是免死金牌：目录结构再好，也替代不了人对关键变更的 review。
• 维护成本转移：技能化之后规则入口变多，需要约定新增/变更规则的放置位置，否则又会变成新的分散。