--- name: automate-me description: "用于‘把我的工作方式自动化’、‘创建/更新/刷新我的 -mode 技能’、‘把我的偏好或工作风格变成技能’,或希望智能体按用户的方式工作。通过 create-skill + unslop 起草或修订个人 -mode 技能,并可从近期对话记录补充新证据。" disable-model-invocation: true --- # 把我的工作方式自动化 在 Claude Code 中,每个会话在遵循此技能前,先阅读一次 [Claude Code 适配器](../../docs/harness/claude-code.md)。它将 pstack 技能中的 Cursor 名称映射到 Claude Code。 通过引导流程,把用户的工作惯例变成智能体会遵循的技能。输出是一个为用户定制的 `-mode` 技能,例如 `jay-mode` 或 `priya-mode`。 这个技能编排另外三部分:内联的历史挖掘过程(见第 1 步)、Cursor 内置的 `create-skill`(用于编写),以及 **unslop** 技能(用于文字规范)。它安排它们的顺序,不替代它们。 ## 流程 ### 0. 检查已有技能 递归查找 `.cursor/skills/**/*-mode/SKILL.md` 和 `~/.cursor/skills/*-mode/SKILL.md`,寻找与用户标识匹配的技能。模式技能可以位于个人分类目录 `.cursor/skills//` 中,不一定在顶层。如果已存在,使用 `AskQuestion` 确认意图,除非用户已经说了“更新我的技能”等类似要求: - 更新已有技能,这是重复运行时的默认选择。 - 重新开始,这种情况很少;开始前先问原因。 更新模式会改变后续流程: - 第 1 步只挖掘技能上次编辑之后的历史,时间通过 `git log -1 --format=%cI ` 获取。 - 第 2 步询问发生了什么变化或缺少什么,不从零询问要捕获哪些内容。 - 第 4 步原地编辑已有文件。保留用户未否定的章节,根据新证据修订已有章节,只为真正新增的规则添加章节。 ### 1. 挖掘用户的历史 分派工作之前,定位当前工作区的对话记录。系统提示会指出该工作区的 `agent-transcripts/` 目录。只使用这个路径。不要对 `~/.cursor/projects/*/` 进行跨目录匹配,那会跨过工作区边界,读到无关项目的私人对话。 调查该范围内近期的智能体对话,寻找反复出现的模式。将历史分段后交给多个并行子智能体,例如取最近 2 至 4 周,分为 3 段,让每段都有足够材料。依据 **poteto-mode** 技能的 Subagents 章节,为各子智能体选择适合任务的推理级别以及快速或标准速度。每个负责历史切片的子智能体从主智能体给出的工作区限定路径读取记录,寻找下列信号,并返回简短的结构化模式清单和证据指针。默认值得寻找的信号包括: - 回复偏好,如长度、语气、格式,以及“说得简单些”一类纠正。 - 委派习惯,如子智能体、模型、专用工作流、并行。 - 验证取向,如什么才算“完成”、单元测试与真实复现、审查者。 - 代码和文字规范,如风格、引用的原则、lint 和格式化工具。 - 流程惯例,如 worktree、提交、PR、审查与合并工具。 - 元偏好,如任务中修复技能、提出新技能。 将某个信号提升为规则前,先跨切片交叉检查。出现在至少 2 个切片中的模式可信度高。孤立信号较弱,通常应舍弃。 ### 2. 直接询问用户 挖掘会遗漏尚未在历史中出现的意图。使用 `AskQuestion` 工具,以结构化多选代替让用户从空白开始输入。 形式是一个或两个问题,每个问题 4 至 6 个选项;分类问题设为 `allow_multiple: true`。从宽泛问题开始,例如“哪些方面最重要?”,再针对选中的方面提供具体选项。结构化轮次结束后,用一个开放聊天问题补上选项没覆盖的内容。 不要一下抛出 20 个问题。 ### 3. 聚类发现 把合并后的信号整理为章节。常见章节如下,只使用实际适用的: - **回复风格**:长度、语气、格式。 - **自主性**:不询问即可做到什么程度、MCP 工具使用。 - **先理解**:界定或调查变更时应使用哪些技能。 - **子智能体**:默认选择、并行、模型与任务匹配、专用工作流。 - **文字与代码规范**:原则、lint 工具、风格指南。 - **审查与验证**:复现取向、验证技能、真实测试工具。 - **流程**:Git worktree、提交、PR、审查与合并工具。 - **技能**:技能编写习惯、先修复技能、提出新技能。 **poteto-mode** 技能展示了这种形态。阅读它来了解颗粒度,不要复制它的内容。用户的规则与 poteto-mode 的规则并不相同。 ### 4. 起草技能 使用 Cursor 内置的 `create-skill` 技能编写技能。放置方式: - 路径:保留已有模式技能的分类。新模式若在仓库中已有该标识的个人分类,使用 `.cursor/skills//-mode/SKILL.md`。否则默认放在项目中的 `.cursor/skills/-mode/SKILL.md`;若用户更偏好个人技能,则放在 `~/.cursor/skills/-mode/`。 - 标识:使用用户的名字或所选标识。 - frontmatter 的 `description`:以用户名字、`/-mode` 和“按其风格工作”为触发条件,不要使用“写代码”或“审查 PR”这类泛化关键词。 - frontmatter 格式:遵循 `create-skill` 的 YAML 规则。`description` 保持为一个 YAML 标量。标点或换行需要时,加引号,或使用 `description: >-` 并缩进后续行。 - frontmatter 的 `disable-model-invocation` 默认设为 `true`。只有用户明确希望每轮都应用其模式时才取消。 ### 5. 迭代文字 逐行应用 **unslop** 技能和 `create-skill` 的写作指南。 向用户展示草稿并接收反馈,预期会有多轮迭代。果断删减。模式技能不是手册。 ### 6. 落地 在从 main 创建的 worktree 中工作。提交并打开 PR,不直接推送到 main。 ## 边界 - **不要对一次对话过拟合。** 某个偏好在一次对话中出现、另一次却被否定,这是噪声。形成规则前要求多次实例。 - **不要卖弄。** 重述其他技能内容、编造比喻,或给智能体读者写“诗意”文字,只增加成本,没有收益。保持可操作。 - **引用,不要内联。** 用户依赖的其他技能应以路径引用呈现,不粘贴摘录。用户在别处维护的原则文档同理。 - **章节保持最少。** 只有用户在某方面有具体、非默认规则时才新增章节。“沟通清晰”不是一个章节;“短段落。比较选项时用表格。只有条目确实平行时才用列表”才是。 - **命名惯例保持通用。** 祈使句使用“用户”或“人”,不使用作者名字。 - **不要强求对称。** 如果用户没有值得记录的流程规则,就完全省略“流程”章节。 ## 评估 `-mode` 技能是主观产物。类似 `create-skill` 的测试与迭代基准循环在这里没有帮助。与用户一起判断:读起来像他们吗?漏了什么吗?然后交付。 只有技能的触发准确性在实际使用中成为问题时,才运行描述优化循环。 ## 不适用的情况 - 用户要的是特定任务技能,而非工作惯例:单用 `create-skill` 即可,不需要挖掘历史。 - 用户只想捕获一个窄工作流,例如“我如何写提交消息”:这是普通技能,不是模式技能。