SuperAPI AI 工具集

pstack-automate-me

智能体与模型

查看项目

更新于 10-28 16:14

技能介绍

用途

pstack-automate-me 是一个“引导式流程”技能,用来把用户已经形成的工作惯例,转化为智能体后续会遵循的一份个性化模式技能。产物是一份以用户名字或标识命名的 -mode 技能,例如 jay-mode、priya-mode。

它本身不负责挖掘、写作或文字打磨,而是编排另外三个技能:/pstack-recall(仓库范围内的会话历史发现)、/writing-for-agents(技能撰写)、/pstack-unslop(文字纪律),并为它们排序。

主要流程

  1. 检查是否已有技能:在项目的技能目录(如 skills/、.agents/skills/、.claude/skills/)以及个人目录(如 ~/.agents/skills/、~/.codex/skills/、~/.claude/skills/)中递归查找与用户 handle 匹配的 *-mode/SKILL.md。模式技能也可能位于个人分类目录(<skills-root>/<handle>/)。已安装的副本只作为发现输入,不作为编辑目标;需要找到其源仓库并在源仓库中操作。若已存在,通过宿主的结构化提问工具确认意图:更新已有技能(重复运行时的默认项)还是重新开始(少见,需先问原因)。选择“更新”时,后续流程只挖掘上次编辑之后的 git 历史(git log -1 --format=%cI <path>),提问改为问“有什么变化或缺失”,并在原文件上就地编辑,保留未被用户否定的章节。

  2. 挖掘历史:先定位当前活跃仓库的会话记录,仅调用 /pstack-recall 做范围内会话发现,列出指定时间窗内该仓库的 Codex 与 Claude Code 会话,不读取其他仓库的历史。随后通过 /pstack-swarm 并行运行多个子智能体,按时间切片(例如最近 2–4 周分成 3 片)扫描反复出现的模式。每个切片子智能体通过 /pstack-recall 的仓库范围读取器读取会话,寻找如下信号:响应偏好(长度、语气、格式、“讲简单点”类纠正)、委派习惯(子智能体、模型、专用工作流、并行度)、验证姿态(“完成”的定义、单元测试还是实机复现、审查者)、代码与文字纪律(风格、引用的原则、lint/format 工具)、流程惯例(工作树、提交、PR、审查/合并工具)、元偏好(任务中途修技能、提议新技能)。跨切片交叉核对后再提升信号,出现在 2 个及以上切片中的模式为高置信,孤立信号通常丢弃。

  3. 直接询问用户:挖掘无法覆盖尚未出现的意图。使用宿主的结构化多选提问工具,而非让用户从零打字。形式为一到两个问题、每题 4–6 个选项,类别题允许多选;若宿主工具每题只接受一个选项或没有该工具,则以编号列表给出同样选项并接受一次回复多个编号。先问宽泛问题(“哪些领域最重要?”),再针对所选领域追问具体选项,结构化轮次结束后用一个自由问答捕捉遗漏。不要一次抛 20 个问题。

  4. 聚类发现:把合并后的信号分组成章节,常用章节包括响应风格、自主性、先理解、子智能体、文字/代码纪律、审查与验证、流程、技能。仅使用适用的章节。挖掘中反复出现的错误应交给 /pstack-correct 做结构性预防,而不只是写成一条模式规则。

  5. 起草技能:使用 /writing-for-agents 撰写。路径方面:已有模式技能保留其分类;新模式下,若仓库已为该 handle 建立个人分类,则用 <skills-root>/<handle>/<handle>-mode/SKILL.md,否则默认 <skills-root>/<handle>-mode/SKILL.md(或用户偏好的个人技能源)。handle 取用户的名字或选定标识。frontmatter 的 description 应以名字 + /<handle>-mode + “按其风格工作”触发,而非“写代码”“审查 PR”之类通用关键词;遵循 /writing-for-agents 的 YAML 规则,保持 description 为单个 YAML 标量,必要时加引号或使用 description: >- 加缩进续行。frontmatter 默认 disable-model-invocation: true,并在 Codex 的 agents/openai.yaml 中镜像为 policy.allow_implicit_invocation: false;仅当用户明确希望其模式在每一轮都生效时才选择退出。技能中不得保留原始对话引文、组织细节和凭据。

  6. 打磨文字并落地:对每一行应用 /pstack-unslop 和 /writing-for-agents 的写作规范,给用户看草稿并收集反馈,预期多轮迭代、果断删减。在基于 main 的工作树中工作,按仓库惯例提交并开草稿 PR,不直接推 main。

适用场景

用户希望把自己的工作惯例(响应风格、委派习惯、验证标准、流程偏好等)固化成智能体可遵循的模式技能;或希望更新已有模式技能。

限制与注意事项

  • 只读取当前活跃仓库范围内的会话历史,避免跨工作区读取无关项目的私密对话。
  • 不过度拟合:只出现一次又被否定的偏好视为噪声,需多次出现才写入。
  • 保持操作性,不重述其他技能内容、不造隐喻、不写“诗意”文字。
  • 引用而非内联:用户依赖的其他技能以 /skill-name 调用形式出现,不粘贴摘录。
  • 章节最小化:只在用户有非默认具体规则时才加章节;“表达清晰”不算章节,“短段落、比较选项时用表格、仅真正并列时用项目符号”才算。
  • 命名使用通用称呼“用户”或“人类”,不用作者名字。
  • 不强制对称,没有值得记录的流程规则就跳过流程章节。
  • 评估方式是主观检查:与用户确认“读起来像不像他/她”“有没有遗漏”,再发布;仅在触发准确性实际出问题时才做 description 优化循环。
  • 不适用于:用户想要任务专用技能(只需 /writing-for-agents,无需挖掘);或只想记录一个狭窄工作流(如“我怎么写提交信息”),那属于普通技能而非模式技能。