Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

design-handoff

/design-handoff

Projektuje nową funkcję lub system, sprawdza fakty w kodzie i SDK, pisze spec i plan, i przekazuje wdrożenie innej sesji.

Repozytorium
TCode ↗
Licencja
MIT
Ostatnia zmiana repozytorium
03.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 03.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Projektuje nową funkcję lub system, sprawdza fakty w kodzie i SDK, pisze spec i plan, i przekazuje wdrożenie innej sesji.

Oryginalny opis (EN)

为本项目设计一个新功能或系统,并交接给新会话实现:先调研核实(读代码和 SDK 源码,把事实钉死,不猜),产出 spec(.local/agent-work/spec/)和实现计划(.local/agent-work/plan/),建好跨会话沟通频道(.local/agent-work/channel/<topic>/HANDOFF.md)。协议是双向阶段闸门:实现方发帖后停下等评审,评审方回复后停下等实现方。最后按项目约定收尾(更新索引,若有)。当用户要求「设计 XX / 写 spec 和 plan / 做交接 / 建个会话来实现它」时使用。

Jak działa

  1. 第 0 步:调研并核实(最重要)
  2. 第 1 步:写 spec —— .local/agent-work/spec/<topic>.md
  3. 第 2 步:写 plan —— .local/agent-work/plan/<topic>-plan.md
  4. 第 3 步:建频道 —— .local/agent-work/channel/<topic>/HANDOFF.md
  5. 第 4 步:收尾
  6. 反模式
Sekcje z nagłówków SKILL.md, w oryginale · 79 linii, 192 słów
Podgląd SKILL.md
---
name: design-handoff
description: 为本项目设计一个新功能或系统,并交接给新会话实现:先调研核实(读代码和 SDK 源码,把事实钉死,不猜),产出 spec(.local/agent-work/spec/)和实现计划(.local/agent-work/plan/),建好跨会话沟通频道(.local/agent-work/channel/<topic>/HANDOFF.md)。协议是双向阶段闸门:实现方发帖后停下等评审,评审方回复后停下等实现方。最后按项目约定收尾(更新索引,若有)。当用户要求「设计 XX / 写 spec 和 plan / 做交接 / 建个会话来实现它」时使用。
---

# 设计 + 交接工作流(发起方)

把想清楚、写下来、交给下一个会话,落成三份产物:spec(决策)、plan(文件级执行)、HANDOFF(新会话入口)。目录不存在就先 mkdir -p。

## 第 0 步:调研并核实(最重要)

1. 读项目的索引文档(若有,AGENTS.md 通常指向它)和相关代码。
2. 核实,不要猜。任何关于 SDK、API、外部依赖行为的关键论断,都要去 node_modules 的源码或 .d.ts 或官方文档读清楚,并记下来源(file:line)。
3. 先盘现有 UI 和基础设施。常常已经有一半,设计只需补缺的那半。
4. 对比要落到结论。给对比表,说明为何排除其他方案。不要只罗列可能性。

## 第 1 步:写 spec —— .local/agent-work/spec/<topic>.md

决策层文档,回答「为什么这么定」,不含文件级任务拆解。内容:

- 背景和现状
- 目标和非目标
- 核心决策(对比表加机制一句话)
- 架构和代码落点
- 契约(参数 schema、跨进程类型、details 形状)
- 安全清单
- 里程碑
- 风险和已核实事实。列来源,未核实的标「待核实」。

## 第 2 步:写 plan —— .local/agent-work/plan/<topic>-plan.md

执行层文档,实现方照着做。内容:

- 阶段 0 冒烟验证:把 spec 里每条「待核实」变成可执行的断言脚本,给出通过标准。失败就发帖到频道,禁止绕过。
- 后续阶段按文件拆任务:每个任务写清改或建哪个文件、怎么做、加哪些测试。
- 验收清单:typecheck、lint、test 全绿,加逐条手动测试和收尾纪律。
- 明确不做的清单。
- 引用 spec,不要复述。

## 第 3 步:建频道 —— .local/agent-work/channel/<topic>/HANDOFF.md

新会话的唯一入口。要自包含,不依赖聊天历史。包含:

1. 一句话任务和完成定义。
2. 必读顺序:HANDOFF、spec、plan、AGENTS.md 及其索引。
3. 关键约束:项目通用纪律,加本任务的硬约束。
4. 已核实事实表(事实、来源)。实现方直接采信,不要重新核实。
5. 待决事项。
6. 沟通协议。
7. 自动唤醒说明:实现方开工时订阅本频道,你的 channel_post 才能唤醒它。
8. 发起方也要订阅:建好频道后立刻 channel_subscribe({ topic }),否则通知链是单向。

### 沟通协议(写进 HANDOFF)

- 实现方:进展、阻塞、决策写进 IMPL-NOTES.md;完成时写 DONE.md。
- 评审方:反馈写进 REVIEW.md;实现方复工前先读。
- 阶段闸门(双方交替,最重要):一个阶段完成等于 git commit(本地,不 push)加写 IMPL-NOTES 加 channel_post(摘要含阶段 N 完成、commit 短哈希、下一步),然后停下(结束回合,不再有工具调用,等对方)。评审方被唤醒后跑回归,写 REVIEW.md,用一条帖回复(明确放行或不放行),再停下等实现方。双方严格交替,不并行。
  - 原因:agent 回合在跑时,对方的帖子投递不进来。实现方停下,工作树静止,评审结论才可信。不停就是边测边改,中间态让测试失去意义。
  - 代价是串行、吞吐低,换来零冲突和可信结论。
- 实现方的完整指令在 channel-pickup 技能里。HANDOFF 只写结论。
- spec 或 plan 与代码冲突:停下,在频道留消息,不要自行绕过。
- channel_post 才通知对方。写完一批文件发一条摘要帖。纯格式或无信息的改动不发帖。禁止碎帖和分次回复。
- 终态退订:任务结束,发起方发 channel_post({ closed: true }),订阅方收取后退订。

## 第 4 步:收尾

不要把 spec、plan 文件放进项目索引。索引最多标出 .local/agent-work/ 目录。HANDOFF.md 带完整路径。没索引就跳过,不要新建。

交付后(用户已开实现会话):你要传达信息,就写文件加发一条摘要,不要等用户转达。零信息不发帖。

作为评审方的节奏:被「阶段 N 完成」唤醒,此时工作树静止,正是跑回归和读 diff 的窗口,写 REVIEW.md,用一条帖明确表态,停下等实现方。不要在实现干活期间零散喂反馈。

回复用户:产物清单、关键决策摘要、以及「新会话从频道里的 HANDOFF.md 进入」。

## 反模式

- 把实现细节堆进 spec,或在 plan 里复述设计论证。
- 把未核实的 API 论断当事实。
- HANDOFF 里写「见上面的讨论」。
- 高频碎帖或零信息帖。
- 做完一阶段就顺手开下一个。
- 协议里写「发帖等评审」却不定义「停」。

Wersje

RepozytoriumWynikLicencja
Ta strona · liassy-ai/TCode90MIT
anthropics/knowledge-work-plugins100Apache-2.0
uw-ssec/rse-plugins100BSD-3-Clause
Suraj-Dhal/Suraj_Dhal_Portfolio100MIT
owl-listener/designpowers100MIT
getcrew44/crew4490MIT

Migawka bazy z 13.11.2026 · wersja paczki dad18d9abbd4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90channel-pickup
    Przejmuje przekazane zadanie implementacyjne z kanału komunikacji między sesjami: czyta plany, realizuje etapy i zbiera uwagi.
  • 100s08-04-spec-plan
    Tworzy techniczny plan wdrożenia plan.md ze specyfikacji i zamrożonych kontraktów: architekturę, pliki, dane, interfejsy, migracje i ryzyka.
  • 100s08-05-spec-tasks
    Dzieli plan na zadania w kolejności zależności, z właścicielem, szacunkiem czasu i kryteriami akceptacji w pliku tasks.md.
  • 95flow-next-plan
    Rozpisuje funkcję na specyfikację i zadania w katalogu .flow, gdy trzeba zaplanować lub rozbić pracę na identyfikatory fn-N.
  • 95r-spec
    Zamienia pomysł na nową funkcję lub podsystem w specyfikację architektoniczną, dzięki dialogowi opartemu na researchu.
  • 90spec-driven-development
    Planuje, wdraża lub przegląda pracę w podejściu spec driven development w istniejącym kodzie z kontrolami zgodności, bezpieczeństwa i weryfikacji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.