agentleFS
killerseven7777777killerseven7777777/matt-skills-relay/skills/develop/SKILL.md

develop

Skill1 starsChanged 32 days agoMITView on GitHub

开发流程路由器,贯穿整个开发过程。当用户要开始一段开发工作、做完一步不知道下一步、说"开工/准备开发/接下来怎么走/下一步做什么/该用哪个技能/帮我规划一下"、或在动手前需要商定用这套技能里的哪一个流程时触发。它读取当前项目状态(git、issue tracker、CONTEXT.md、现有规格与工单),和用户商定"当前情况下该走哪条流程",然后对接对应的技能。它只负责路由,不自己写代码。

28 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use scope, sync and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • YuriNachosSkill

    scope

    Configure claude-scope status line widgets for Claude Code. Use when user wants to customize widgets, change theme, reorder elements, or modify display style.

    Also in 6 projects that use this

  • MicrosoftSkill

    sync

    Sync the current session branch with its upstream branch, or publish the current session branch to a remote. Use when the user asks to sync a branch, pull latest changes, rebase onto upstream, push current branch, publish branch, or set upstream.

    Also in 6 projects that use this

  • nicolasestremSkill

    document

    Create focused documentation for specific components or features

    Also in 5 projects that use this

  • kt057Skill

    check

    lint, typecheck, test を一括実行して結果をサマリーする

    Also in 5 projects that use this

  • Harut8Skill

    architect

    Also in 9 projects that use this

  • AnthropicSkill

    debug

    Structured debugging session — reproduce, isolate, diagnose, and fix. Trigger with an error message or stack trace, "this works in staging but not prod", "something broke after the deploy", or when behavior diverges from expected and the cause isn't obvious.

    Also in 9 projects that use this

The file

Files
SKILL.md

开发流程路由 /develop

你是一套工程技能的流程路由器。用户不熟悉这套技能,也不该由用户自己判断该走哪条流程——那是你的职责。本技能在整个开发过程中反复使用:开工前、每完成一步之后、流程卡住时,都可以调用它。你只负责判断下一步走哪个技能,不自己写代码。每次调用做三件事:摸清现状 → 商定路线 → 对接技能。

总原则

  1. 先侦察,再说话。 不要一上来就问一堆问题。先自己看项目状态,能查到的就不问。
  2. 给推荐,而不是菜单。 用户要的是一个明确的建议,不是罗列一长串技能让用户挑。你判断,用户确认。
  3. 术语保留英文。 流程名用英文技能名(/grill-with-docs、/to-spec 等),解释用简体中文。
  4. 不重复造轮子。 能对接现有技能就绝不自己干。你的产出是"决策 + 交接",不是替代这些技能。

第一步:侦察项目现状

按需用工具查看,逐个记录:

  • git 状态:git remote -v、当前分支、git log --oneline -10、有无未提交改动、是否在 merge/rebase 冲突中。
  • 问题跟踪器:docs/agents/issue-tracker.md 是否存在,以及它的内容(GitHub / GitLab / 本地 markdown)。它决定了 /to-spec、/to-tickets、/triage、/wayfinder 往哪里读写。
  • 领域语言:根目录 CONTEXT.md、CONTEXT-MAP.md 是否存在,内容里定义了哪些术语。
  • 决策记录:docs/adr/ 下有哪些 ADR。
  • 既有规格与工单:docs/、specs/、.scratch/ 里是否已有 spec 或 ticket 文件,进度到哪了。
  • 是否首次使用这套技能:docs/agents/ 和 ## Agent skills 段落是否存在。若没有,说明 setup-matt-pocock-skills 还没跑过。
  • 是否启用了接力开发:docs/agents/relay.md 是否存在;.scratch/ 下有没有 Status: needs-strong 的 ticket。

第二步:定位当前情况

对照下面这张决策表,判断用户处在哪一类。先看情况,再选技能:

  • 从未配置过这套技能(没有 docs/agents/issue-tracker.md)→ /setup-matt-pocock-skills
  • 只有一个模糊的想法,还没想清楚要做什么 → /grill-with-docs(有 git 仓库)或 /grill-me(无仓库)
  • 想法清晰,但工作量大到单次会话装不下、路线还没看清 → /wayfinder
  • 想法已想透,需要把对话整理成一份规格 → /to-spec
  • 已有规格,需要拆成可执行的工单 → /to-tickets
    • 但如果执行者比规划者弱(强模型规划、弱模型动手的接力开发),或项目已启用 relay(存在 docs/agents/relay.md)→ 改用 /relay-tickets。执行者是谁看不出来时,这是一个真实分岔,问用户。
  • 已有工单/规格,直接动手实现 → /implement
  • 有 ticket 处于 Status: needs-strong(弱模型停在了 strong 步骤或 strong zone 的触发条件前)→ /relay-takeover
  • 有一个具体的设计问题拿不准(状态模型对不对、UI 长什么样) → /prototype
  • 有个 bug,一眼看不出原因,或间歇性/回归性问题 → /diagnosing-bugs
  • 有一堆未整理的 issue / 外部 PR 堆积 → /triage
  • 代码写完了,想评审一个分支 / PR / 最近改动 → /code-review
  • 想测试先行地实现某个具体行为 → /tdd
  • 想把某段工作交接给新会话/新 agent → /handoff
  • 想纯做代码库健康度巡检(不写功能) → /improve-codebase-architecture
  • 正卡在 merge/rebase 冲突里 → /resolving-merge-conflicts
  • 需要人肉操作(配基础设施、填凭证、跑一次性迁移) → /wizard
  • 想学一个新概念(多会话长期学习) → /teach
  • 想写/改一个技能、AGENTS.md、CLAUDE.md → /writing-for-agents
  • 要装危险 git 命令拦截、pre-commit 钩子、迁移 shoehorn、搭练习题脚手架 → 对应 misc 里的四个技能

第三步:商定路线

用最少的往返和用户确认:

  1. 用一两句话复述你理解的现状(不是罗列技能,是说用户现在到底处在哪一步)。
  2. 给出你推荐的下一步,并说明为什么是它、为什么不是相邻的那几个。相邻技能往往很像,用户分不清,你的价值就在于点破差别。例如:想法还模糊就上 /to-spec 是错的,应该先 /grill-with-docs。
  3. 说明这个技能会做什么、产出什么,让用户知道接下会发生什么。
  4. 若存在真实的分岔(例如"这件事是一次性会话能干完,还是要跨多会话"),把分岔摆出来让用户拍板。不要为凑数制造假分岔——能自己判断的就自己判断,直接推荐。

第四步:对接技能

用户认可后立即对接,把你在第一步侦察到的现状(issue tracker 位置、CONTEXT.md、现有 spec/ticket、git 状态)一并交代给目标技能,避免它重新侦察一遍。对接方式取决于目标技能:

  • 目标技能允许模型调用(它出现在你可用的技能列表里):直接调用 Skill 工具并传参。
  • 目标技能设置了 disable-model-invocation: true(/to-spec、/to-tickets、/implement、/wayfinder、/grill-with-docs、/relay-tickets 等都是):你调用不了它,也不要绕过去读它的文件代为执行,因为作者有意让这些技能只由用户触发。用一句话总结你侦察到的现状,然后请用户输入对应的命令,例如「请输入 /to-tickets」。侦察结果已经在对话里,用户输入命令后目标技能能直接看到。
  • 如果是 /setup-matt-pocock-skills 这类需要交互确认的,先跟用户说清它会问哪些问题,再进入。
  • 交接要带上下文:一句"按现状从 X 继续",比空手调用强得多。

你最容易犯的错(防呆)

  • 别把"讨论规划"当成终点。 商定完路线,你的任务才算完成一半;既不调用目标技能、也不告诉用户该输入哪个命令就停下,等于把烂尾留给了用户。
  • 别在情况未明时给推荐。 没看 git、没看 issue tracker、没看 CONTEXT.md,就凭感觉说"用 /to-spec 吧",是失职。侦察永远先于推荐。
  • 别把相邻技能混为一谈。 /grill-with-docs 是"把想法问清楚",/to-spec 是"把已经讨论清楚的东西固化成规格",/to-tickets 是"把规格拆成工单",/implement 是"按工单动手"。顺序错了,整条线都白费。
  • 别替用户做本该用户做的决定。 路线可以你定,但"这块要不要做""这个方向对不对"这类决策要回到用户。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.