Communitygithub.com

mattpocock/loop-me——工作流规格式审问

在您的工作区内,持续盘问您想要构建的工作流规范,直到规格明确、可执行。

loop-me——工作流规格式审问 是什么?

这个技能创建了一个有状态的 `/grilling` 会话,其唯一产出是**工作流**规格。它采用一种“盘问式”方法,即一轮接一轮地提问,并为每个问题附上推荐的答案。该技能的核心概念是“循环”(Loop)——用户生活中重复出现的模式(如职业生涯、每周、每天或单个重复活动),以及“工作流”(Workflow)——对一个循环的规格化实现,存储在 `workflows/*.md` 文件中。技能定义了一套共享词汇(触发事件、检查点、向右推、简报)来精确描述工作流,但强调结构非强制性,即工作流不需要 AI、检查点或日程,除非盘问证明其必要性。其“完成定义”非常严格:只有当实现者无需再问任何问题就能直接构建时,工作流规格才算完成。该技能还维护 `NOTES.md` 文件,用于记录用户的工具、渠道和术语,当该文件为空时,会先进行访谈。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/in-progress/loop-me

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

运行一个有状态的 /grilling 会话,其唯一产出是工作流规格。采用盘问式方法(一轮接一轮地提问,每个问题附带一个推荐答案),目标是对齐以下词汇和描述的目标流程。在盘问过程中,根据决议创建、编辑和删除规格文件。

循环透镜

循环是用户生活中重复出现的模式:他们的职业生涯、他们的一周、他们的早晨、一个单个的重复活动。将生活想象成嵌套的循环,就能揭示其活动实际上有多么可预测,这正是使其值得委派的原因。使用此透镜来发现值得规格化的循环,并提出用户尚未注意到的循环。

工作流是对一个循环的规格化实现。您在一个循环上运行一个工作流:该循环就是它的运行实例。工作流存放在 workflows/*.md 中,是事实来源。

词汇

一种共享语言,仅在工作流需要时才使用:绝不是检查清单。绝不强制任何结构:工作流不需要 AI、不需要检查点,也不需要日程,除非盘问表明它确实需要。

  • 触发事件:触发每次运行的因素,可以是事件(一封新邮件、一个新问题)或日程(每天早上)。事件触发通常效率更高。
  • 检查点:人类介入的节点,在此用户需要验证或决策。有些工作流没有检查点,完全自主运行;有些则完全不使用 AI。
  • 向右推:尽可能将检查点向后推迟。在涉及人类之前完成最大化的工作,这样他们只需在最后被询问一次,并且所有内容都已准备就绪。
  • 简报:检查点呈现的内容,是一份简洁、可决策的摘要(说明了产生什么、为什么这样,以及指向资产的链接),绝不输出原始结果。用户阅读的是简报,而不是草稿。审查速度至关重要。

完成定义

一个工作流规格在实现者无需问任何问题即可构建时才算完成。持续盘问直到达到该状态;只要还有一个问题未解决,就什么都没完成。

工作区

  • workflows/*.md:每个工作流对应一个规格文件。
  • NOTES.md:关于用户世界的原始笔记,包括他们使用的工具、处理的渠道以及他们自己对这两者的术语。当此文件为空或内容单薄时,在开始规格化之前先访谈他们,了解他们的世界。随着模糊术语浮现,将其精炼为标准术语,并记录在此处。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

相关技能