feat: update
This commit is contained in:
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: skill-name
|
||||
description: >-
|
||||
简要描述 skill 做什么、何时触发。写入用户可能使用的触发表达，让 Agent 能自动匹配。
|
||||
显式调用门槛：仅在用户显式调用 `/<skill-name>` 或 `$<skill-name>`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。简要描述 skill 做什么，以及显式调用后的使用范围。
|
||||
---
|
||||
|
||||
# Skill 名称
|
||||
@@ -10,10 +11,10 @@ description: >-
|
||||
|
||||
---
|
||||
|
||||
## 何时使用
|
||||
## 显式调用后的适用范围
|
||||
|
||||
- 触发场景 1
|
||||
- 触发场景 2
|
||||
- 显式调用后的场景 1
|
||||
- 显式调用后的场景 2
|
||||
|
||||
## 不适用
|
||||
|
||||
|
||||
+2
-1
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: ack
|
||||
description: >-
|
||||
初始化、检查并运行 ACK 三角色闭环。仅在用户显式调用 /ack 或 $ack，并要求
|
||||
显式调用门槛：仅在用户显式调用 `/ack` 或 `$ack`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
初始化、检查并运行 ACK 三角色闭环。显式调用后可要求
|
||||
初始化 ACK、检查 .pouch/ack、按 ACK 做需求或修 bug、指挥
|
||||
Coordinator/Developer/Test、配置或运行测试环境与发版、或跑回归时使用。
|
||||
---
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: agent-runtime
|
||||
description: >-
|
||||
维护项目通用 Agent 运行配置、环境绑定、Orca worktree 与跨 session terminal；
|
||||
显式调用门槛：仅在用户显式调用 `/agent-runtime` 或 `$agent-runtime`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。维护项目通用 Agent 运行配置、环境绑定、Orca worktree 与跨 session terminal；
|
||||
适用于 builder.android、builder.ios、tester.test、ack.dev 等可扩展绑定。
|
||||
不负责具体构建、测试或 ACK 闭环。
|
||||
---
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: android-tester
|
||||
description: >-
|
||||
检查并运行 Android 真机或模拟器测试；支持 Debian amd64 上安装
|
||||
Android Emulator、KVM 依赖、SDK 工具和 AVD。触发词：Android 测试、安卓测试、
|
||||
真机测试、Android 模拟器、AVD、ADB、安装安卓模拟器、检查 Android 环境。
|
||||
显式调用门槛：仅在用户显式调用 `/android-tester` 或 `$android-tester`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。检查并运行 Android 真机或模拟器测试；支持 Debian amd64 上安装
|
||||
Android Emulator、KVM 依赖、SDK 工具和 AVD。显式调用后的范围包括：Android 测试、安卓测试、
|
||||
真机测试、Android 模拟器、AVD、ADB、安装安卓模拟器和检查 Android 环境。
|
||||
---
|
||||
|
||||
# Android Tester
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: bugfix-ship
|
||||
description: >-
|
||||
【已弃用，兼容占位】bugfix-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
显式调用门槛：仅在用户显式调用 `/bugfix-ship` 或 `$bugfix-ship`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。【已弃用，兼容占位】bugfix-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
流程，直接读取 ../ship/SKILL.md 并按其执行；本次按 short 模式。小需求、小改动、
|
||||
修 bug、改文案、加按钮、修复后发 PR 或部署都属于 ship。
|
||||
---
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
name: builder
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/builder` 或 `$builder`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
初始化或检查 makefile.builder 契约，再构建或发布 deb/镜像/Android APK/iOS IPA，
|
||||
或把产物拷到目录/容器。产物可在本机或 CI 上构建；拿到产物用 obtain。触发词：初始化
|
||||
或把产物拷到目录/容器。产物可在本机或 CI 上构建；拿到产物用 obtain。显式调用后的范围包括：初始化
|
||||
builder、检查 makefile.builder、构建/发布 deb、推送 apt、构建/发布 Docker 镜像、
|
||||
打 APK/IPA、拷到 File Browser、make push、看构建、监听 CI、obtain。
|
||||
打 APK/IPA、拷到 File Browser、make push、看构建、监听 CI 和 obtain。
|
||||
未授权不上传。Docker 仅用户点名镜像时才走。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
---
|
||||
name: declarative-openspec-loop
|
||||
description: 声明式编程循环 - 用户提供校验方式，Agent 自动 propose/apply/校验并迭代直到通过。Use when the user provides expectations or a verification method and wants the agent to implement, verify, and iterate until expectations pass. Triggers on 声明式编程、按预期循环、做到校验通过、declarative loop.
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/declarative-openspec-loop` 或 `$declarative-openspec-loop`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。声明式编程循环：用户提供校验方式，Agent 自动 propose/apply/校验并迭代直到通过。
|
||||
---
|
||||
|
||||
# 声明式 OpenSpec 循环
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
---
|
||||
name: delivery-loop
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/delivery-loop` 或 `$delivery-loop`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
为修复、PR 和需求任务提供可配置的验证、发 PR、合并、回归、构建、发布与部署状态机。
|
||||
仅作为 ship、pr-ship 的共享执行规则使用。
|
||||
---
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: deployer
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/deployer` 或 `$deployer`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
初始化或检查项目部署配置；管理测试环境的本机 Docker Compose、通过 app00 Agent
|
||||
terminal 触发正式环境部署，以及 Argo CD GitOps（改清单开 MR，用户合并后同步）。触发词：初始化
|
||||
deployer、部署、sync、升级、装 deb、ArgoCD、GitOps；ACK 拉起测试环境时也可使用。
|
||||
terminal 触发正式环境部署，以及 Argo CD GitOps（改清单开 MR，用户合并后同步）。显式调用后的范围包括：初始化
|
||||
deployer、部署、sync、升级、装 deb、ArgoCD、GitOps，以及 ACK 拉起测试环境。
|
||||
---
|
||||
|
||||
# deployer：测试本机 Compose、正式 Agent 部署与 Argo CD GitOps
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: discussion-notes
|
||||
description: >-
|
||||
讨论沉淀模式：协作问答并持续更新 Markdown 笔记。Use when the user invokes
|
||||
discussion-notes, asks to enter 讨论模式, or wants to 沉淀到文档/整理笔记 during
|
||||
learning or decision conversations. Triggers on 讨论模式、讨论沉淀、记笔记、单开文档.
|
||||
显式调用门槛：仅在用户显式调用 `/discussion-notes` 或 `$discussion-notes`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。讨论沉淀模式：协作问答并持续更新 Markdown 笔记。显式调用后用于
|
||||
讨论模式、讨论沉淀、记笔记、单开文档，以及学习或决策对话中的持续整理。
|
||||
No .raw.md—only living curated notes updated each round.
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: draw-prototype-flow
|
||||
description: >-
|
||||
将产品想法、需求文档或现有系统整理成可编辑的低保真 Draw.io 原型、用户动线和产品规则说明板。
|
||||
当用户提出画原型图、线框图、用户流程、用户动线、页面跳转、交互状态、wireframe、user flow、
|
||||
UX flow、产品方案可视化，或要求检查和完善现有 .drawio 产品原型时使用。适合同时表达页面、弹窗、
|
||||
显式调用门槛：仅在用户显式调用 `/draw-prototype-flow` 或 `$draw-prototype-flow`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。将产品想法、需求文档或现有系统整理成可编辑的低保真 Draw.io 原型、用户动线和产品规则说明板。
|
||||
显式调用后用于画原型图、线框图、用户流程、用户动线、页面跳转、交互状态、wireframe、user flow、
|
||||
UX flow、产品方案可视化，或检查和完善现有 .drawio 产品原型。适合同时表达页面、弹窗、
|
||||
异常态、角色权限、状态流转、字段规则与操作反馈；不用于像素级高保真 UI、纯技术架构图或单张插画。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: eli5
|
||||
description: >-
|
||||
用大图少字的单页 HTML 把话题讲给完全没背景的人听。Use when the user types
|
||||
/eli5 <topic>, says eli5, 像五岁小孩一样解释, 用小学生能懂的方式讲, 画图解释,
|
||||
or asks for a dead-simple picture explainer of how something works.
|
||||
显式调用门槛：仅在用户显式调用 `/eli5` 或 `$eli5`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
用大图少字的单页 HTML 把话题讲给完全没背景的人听。显式调用后处理指定 topic，
|
||||
并提供一眼能看懂的图解，而不是聊天长文。
|
||||
---
|
||||
|
||||
# eli5
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
---
|
||||
name: fixds
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/fixds` 或 `$fixds`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
DeepSeek Flash 系模型的行为约束：先验证再实现、搜索必须有边界、不越权改需求
|
||||
或项目外目录、命令一次写对、测试按影响面；用户赶时间时每轮都要逼近结论。
|
||||
用于 DeepSeek Flash / DeepSeek V4.1 Flash（模型标识含 deepseek 与 flash）；
|
||||
用户说 fixds 时同样生效。
|
||||
显式调用后用于 DeepSeek Flash / DeepSeek V4.1 Flash（模型标识含 deepseek 与 flash）。
|
||||
---
|
||||
|
||||
# fixds：DeepSeek Flash 行为约束
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: host-sec-check
|
||||
description: >-
|
||||
Linux/VPS 主机安全检查、入侵取证与用户确认后的分阶段加固：覆盖矿机、隐藏进程/ld.so.preload、对外端口、SSH/Docker/k8s、cron/systemd、hugepage/OOM、SSH/防火墙/Fail2ban。触发：安全检查、安全加固、新机初始化、被黑、入侵、矿机、排查端口、对公网放开、host security、hardening、compromise、/host-sec-check。
|
||||
显式调用门槛：仅在用户显式调用 `/host-sec-check` 或 `$host-sec-check`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
Linux/VPS 主机安全检查、入侵取证与用户确认后的分阶段加固：覆盖矿机、隐藏进程/ld.so.preload、对外端口、SSH/Docker/k8s、cron/systemd、hugepage/OOM、SSH/防火墙/Fail2ban。
|
||||
---
|
||||
|
||||
# host-sec-check
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: ios-tester
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/ios-tester` 或 `$ios-tester`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
检查并运行 iOS 真机或 Xcode Simulator 测试，生成可追溯结果；支持 Linux 上识别
|
||||
不可本地运行 Simulator 的边界，并通过 macOS 或远程 Mac 执行。触发词：iOS 测试、
|
||||
苹果测试、iPhone 真机、iOS Simulator、Xcode 测试、远程 Mac 测试。
|
||||
不可本地运行 Simulator 的边界，并通过 macOS 或远程 Mac 执行。显式调用后的范围包括：iOS 测试、
|
||||
苹果测试、iPhone 真机、iOS Simulator、Xcode 测试和远程 Mac 测试。
|
||||
---
|
||||
|
||||
# iOS Tester
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: knowledge-explainer
|
||||
description: >-
|
||||
把复杂概念、原理、术语和资料讲给没有背景的读者听，先建立直觉，再解释机制、例子和边界。适用于“科普一下”“这是什么”“为什么会这样”“怎么运作”“讲得通俗一点”“帮我理解这篇资料”等请求；不负责单纯校对、翻译或只做格式整理。
|
||||
显式调用门槛：仅在用户显式调用 `/knowledge-explainer` 或 `$knowledge-explainer`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
把复杂概念、原理、术语和资料讲给没有背景的读者听，先建立直觉，再解释机制、例子和边界；不负责单纯校对、翻译或只做格式整理。
|
||||
---
|
||||
|
||||
# 知识科普
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: long-ship
|
||||
description: >-
|
||||
【已弃用，兼容占位】long-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
显式调用门槛：仅在用户显式调用 `/long-ship` 或 `$long-ship`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。【已弃用，兼容占位】long-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
流程，直接读取 ../ship/SKILL.md 并按其执行；本次按 long 模式。复杂需求、跨模块、
|
||||
PRD 批准后开发、拆任务交付都属于 ship。
|
||||
---
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: manage-release
|
||||
description: >-
|
||||
【已弃用，兼容占位】manage-release 已改名为 releaser。命中本 skill 时不要在此执行任何
|
||||
显式调用门槛：仅在用户显式调用 `/manage-release` 或 `$manage-release`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。【已弃用，兼容占位】manage-release 已改名为 releaser。命中本 skill 时不要在此执行任何
|
||||
流程，直接读取 ../releaser/SKILL.md 并按其执行。发布版本、打 release tag、创建平台
|
||||
Release、准备版本变更、hotfix、继续未完成发布等请求都属于 releaser。
|
||||
---
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: memory-distill
|
||||
description: >-
|
||||
任务结束后回顾会话，自动定位目标 skill 的记忆目录，把可沉淀内容写入通用记忆与项目记忆。
|
||||
Use when users say memory-distill, 沉淀记忆, 提炼知识, 回顾刚才, 记下来, 更新记忆,
|
||||
distill memory, harvest session, or ask to capture lessons after ack / release /
|
||||
develop / test workflows. Minimal invoke is enough (e.g. "提炼一下刚刚 ack
|
||||
执行过程中可以沉淀的知识"); resolve missing paths from the target skill's
|
||||
显式调用门槛：仅在用户显式调用 `/memory-distill` 或 `$memory-distill`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。任务结束后回顾会话，定位目标 skill 的记忆目录，把可沉淀内容写入通用记忆与项目记忆。
|
||||
显式调用后的范围包括：memory-distill、沉淀记忆、提炼知识、回顾刚才、记下来、更新记忆、
|
||||
distill memory、harvest session，以及 ack / release / develop / test 工作流后的经验沉淀。可用最小调用
|
||||
（例如“提炼一下刚刚 ack 执行过程中可以沉淀的知识”）；resolve missing paths from the target skill's
|
||||
memories/manifest.md. Not for live discussion notes, research articles, or
|
||||
summaries that must not update memory stores.
|
||||
---
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
---
|
||||
name: note-style
|
||||
description: 将现有材料整理、压缩或改写为可长期查阅的知识笔记，采用教科书、技术手册或标准说明文风格，并保留事实、公式、适用条件、安全警告和参考资料。适用于用户要求整理 Obsidian 笔记、消除聊天或 AI 写作痕迹、减少重复和空话、统一术语与技术表达，或将技术原理、操作方案改写为结构化知识文档的任务。
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/note-style` 或 `$note-style`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
将现有材料整理、压缩或改写为可长期查阅的知识笔记，采用教科书、技术手册或标准说明文风格，并保留事实、公式、适用条件、安全警告和参考资料。
|
||||
---
|
||||
|
||||
# 整理知识笔记
|
||||
|
||||
+3
-2
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: orc
|
||||
description: >-
|
||||
作为薄路由器显式识别开发、源码版本发布、DEB 和 Docker 意图，把阶段分发给对应
|
||||
Skill，并按静态规则选择 low、mid、high 执行档位。仅在用户显式调用 $orc 或 /orc，
|
||||
显式调用门槛：仅在用户显式调用 `/orc` 或 `$orc`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
作为薄路由器识别开发、源码版本发布、DEB 和 Docker 意图，把阶段分发给对应
|
||||
Skill，并按静态规则选择 low、mid、high 执行档位。
|
||||
要求跨阶段协调、指定 Agent 级别、监督多个 worker 或继续 ORC 编排时使用。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
name: pouch
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/pouch` 或 `$pouch`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
创建、校验、转正、安装或发布 ~/.pouch 自研 skill；代装 pouch、介绍 builtin
|
||||
skill、在项目里接入并引导初始化；或优化 skill 分层结构以减少 token 浪费。
|
||||
触发词：pouch、skiff、帮我装 pouch、有哪些 skill、skill 怎么用、接入当前项目、
|
||||
初始化 skill、创建 skill、publish skill、优化 skill 结构、分层加载。
|
||||
显式调用后的范围包括：pouch、skiff、帮我装 pouch、有哪些 skill、skill 怎么用、接入当前项目、
|
||||
初始化 skill、创建 skill、publish skill、优化 skill 结构和分层加载。
|
||||
---
|
||||
|
||||
# pouch 自研 Skill 工作流
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: pr-ship
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/pr-ship` 或 `$pr-ship`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
处理已有 PR/MR：检查差异、审核和 CI，必要时修复阻塞项，合并后以合并 commit 做完整回归，
|
||||
再按配置构建、发布和部署。用户说处理、合并、回归或发布 PR 时使用。
|
||||
再按配置构建、发布和部署。显式调用后用于处理、合并、回归或发布 PR。
|
||||
---
|
||||
|
||||
# PR Ship：合并后的完整交付
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
---
|
||||
name: previewer
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/previewer` 或 `$previewer`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
用 Node 将已有 HTML、PRD、报告、截图或其它静态文件提供为 HTTP 预览。
|
||||
用户说“把这个 HTML 渲染出来”“预览这个文件”“给我预览 URL”时使用；
|
||||
显式调用后用于“把这个 HTML 渲染出来”“预览这个文件”或“给我预览 URL”；
|
||||
不生成页面内容，不执行构建，不配置代理、隧道或动态业务服务。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: product-prototype
|
||||
description: >-
|
||||
将产品需求整理为可校验的文件型 prototype 数据，并复制或维护 React + TypeScript + React Flow
|
||||
Prototype Studio。用户提出做高保真原型、页面动线、原型画布、React Flow 原型、交互预览、
|
||||
原型截图/评审、requirements.md/flow.json/layout.json/review.json，或要求初始化可复用
|
||||
显式调用门槛：仅在用户显式调用 `/product-prototype` 或 `$product-prototype`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。将产品需求整理为可校验的文件型 prototype 数据，并复制或维护 React + TypeScript + React Flow
|
||||
Prototype Studio。显式调用后用于高保真原型、页面动线、原型画布、React Flow 原型、交互预览、
|
||||
原型截图/评审、requirements.md/flow.json/layout.json/review.json，或初始化可复用
|
||||
Prototype Studio 模板时使用。不要用于真实后端、真实设备连接、生产 UI 编辑器或 Figma 双向同步。
|
||||
---
|
||||
|
||||
@@ -41,9 +42,10 @@ description: >-
|
||||
使用稳定错误码和非零退出码，不把缺浏览器、页面失败或宿主环境问题伪装成通过。
|
||||
6. `snapshot` 使用真实 Vite 页面和可发现的 Chrome 生成 PNG 与 manifest；`test` 运行离线合约、
|
||||
mock 检查和 Playwright 交互/三视口检查。测试产物只写入 `.prototype-artifacts/`。
|
||||
7. 增量变更按稳定 ID 维护 flow、layout、review 和相关实现/截图；新增、修改、删除都必须同步
|
||||
7. **最终交付物必须是网络可访问的 HTML 页面。** 原型任务完成前必须运行生产构建或开发服务器，并通过 `http://` URL 访问实际页面；只生成 `dist/index.html` 文件、PNG 截图或 `file://` 链接都不算完成。交付时必须报告访问 URL、启动命令和页面可访问性检查结果。默认优先使用 `npm run dev -- --host 0.0.0.0` 进行评审；需要验证生产产物时先运行 `npm run build`，再使用 `npm run preview -- --host 0.0.0.0` 或等价 HTTP 静态服务器。
|
||||
8. 增量变更按稳定 ID 维护 flow、layout、review 和相关实现/截图；新增、修改、删除都必须同步
|
||||
引用并做离线 diff，不能重编号或漂移无关节点。删除前要报告受影响的边、布局和批注。
|
||||
8. 默认按用户动线分栏评审，先读 [journeys.md](references/journeys.md)：首栏为完整首页，
|
||||
9. 默认按用户动线分栏评审，先读 [journeys.md](references/journeys.md)：首栏为完整首页，
|
||||
后续每栏一个用户任务，横向展示完整页面与本栏主要连线；其它动线另起一栏。
|
||||
分组写入 layout.groups，导航仍由 flow 唯一驱动。总关系图只能作为辅助视图。
|
||||
|
||||
@@ -51,8 +53,7 @@ description: >-
|
||||
|
||||
- 输入：需求目标、用户场景、页面/状态清单、关键交互、验收上下文和可选的现有项目路径。
|
||||
- 源数据：项目目录中的 `prototype/requirements.md`、`flow.json`、`layout.json`、`review.json`。
|
||||
- 输出：可复制的 npm 项目、可追踪的稳定 ID、离线文档、可运行的 Studio/runtime 预览和可复核
|
||||
的截图/测试产物。
|
||||
- 输出：可复制的 npm 项目、可追踪的稳定 ID、离线文档、可运行的 Studio/runtime 预览、网络可访问的 HTML 页面 URL，以及可复核的截图/测试产物。
|
||||
- 生成物：截图、报告和测试输出只能写入项目约定的 artifacts 目录；它们不是源数据。
|
||||
|
||||
## 命名与版本策略
|
||||
@@ -86,3 +87,4 @@ description: >-
|
||||
- `init` 重复运行不会覆盖已有源数据；静态检查失败时返回非零码并指出文件。
|
||||
- `validate`、离线合约、增量检查和 TypeScript/Vite build 可复核；浏览器截图与 Playwright 结果
|
||||
必须按实际环境报告，未运行或因宿主环境失败的项目只能记录为 test gap。
|
||||
- 原型交付必须额外验证 `http://` 页面：服务进程成功启动、入口 HTML 返回成功、页面根节点和首屏动线可见；若无法启动 HTTP 服务，必须明确报告为未完成，不能用本地文件路径替代。
|
||||
|
||||
@@ -15,6 +15,9 @@
|
||||
都应非零退出。`snapshot` 覆盖 device-management 的 list/create/config/connecting/connected/
|
||||
failed/detail/empty 八个页面和 desktop/tablet/mobile 三种视口（24 张 PNG），manifest 在全部
|
||||
截图完成后原子发布，不能用 SVG、占位图或手工假截图代替。
|
||||
截图不是原型的最终交付物。最终交付必须是通过 HTTP 服务访问的 HTML 页面；截图只作为评审
|
||||
证据。交付记录必须包含页面 URL 和 HTTP 可访问性检查，不得只提供 `dist/index.html` 或
|
||||
`file://` 路径。
|
||||
默认动线视图另生成 desktop/tablet/mobile 三张完整预览，manifest 用 groupIds 记录分组；
|
||||
设备示例的 24 张页面截图保留在辅助画布视图中生成，总计 27 张。
|
||||
`npm test` 的 Playwright HTML 报告和失败 trace 写入 `.prototype-artifacts/playwright-report/`
|
||||
|
||||
@@ -9,6 +9,7 @@
|
||||
| `validate` | schema、引用、可达性、注册表和条件规则全量检查 | 已实现，支持 `--data-dir`、`--json`、`--quiet` |
|
||||
| `snapshot` | 启动/连接 Vite，以 Chrome 实际渲染并生成桌面/平板/移动 PNG + manifest | 已实现；`BROWSER_MISSING`、页面/截图/目录失败非零，manifest 原子发布 |
|
||||
| `build` | TypeScript 检查和生产构建 | 已实现：`tsc --noEmit` + `vite build` |
|
||||
| `serve` | 通过 HTTP 暴露构建后的 HTML 页面，供评审或联调访问 | 交付必做；必须报告实际 `http://` URL 和入口页面检查结果 |
|
||||
| `test:incremental` | 离线检查 flow/layout/review 的稳定 ID 新增、修改、删除边界 | 已实现；不启动浏览器、不改源数据 |
|
||||
| `test` | 确定性 runtime/mock 合约 + Playwright 关键交互和三视口加载 | 已实现；浏览器/页面/断言失败非零，环境错误不跳过 |
|
||||
|
||||
@@ -35,3 +36,16 @@ review 的稳定 ID 边界 fixture。`snapshot` 默认写 `.prototype-artifacts/
|
||||
`init` 的失败码为 2，参数/目标/写入错误分别带稳定 code；`validate` 失败码为 1（未知参数
|
||||
为 2），每个错误均输出 `file :: id :: code :: message`。`build` 依次执行 `tsc --noEmit`
|
||||
和 `vite build`；`test` 先执行离线合约，再执行 `playwright test`。
|
||||
|
||||
## HTML 页面交付
|
||||
|
||||
`dist/index.html` 是构建输入，不是最终交付本身。完成原型后必须通过 HTTP 服务器暴露页面：
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
npm run preview -- --host 0.0.0.0
|
||||
```
|
||||
|
||||
如果项目没有 `preview` script，可使用 `npx vite preview --host 0.0.0.0` 或等价静态服务器。
|
||||
交付报告至少包含：访问 URL、使用的启动命令、HTTP 入口成功状态，以及首屏/关键动线已加载的
|
||||
验证结果。不要把 `file:///.../dist/index.html` 当作最终 URL。
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
name: releaser
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/releaser` 或 `$releaser`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
管理 Git 项目从已准备 commit 到版本发布的生命周期：发现并遵循项目版本与发布策略，
|
||||
优先为远端已验证 commit 生成更新说明并创建 annotated release tag，按需创建 Forge
|
||||
Release；只有必须修改版本文件或仓库内发布说明时，才创建或复用版本分支、worktree
|
||||
和 PR/MR。也支持恢复中断流程与安全清理。用户要求发布版本、打 release tag、创建
|
||||
和 PR/MR。也支持恢复中断流程与安全清理。显式调用后用于发布版本、打 release tag、创建
|
||||
平台 Release、准备版本变更、处理 hotfix 或继续未完成发布时使用。只做普通编码、普通
|
||||
worktree 或 PR/MR 操作、代码审查、构建或上传 DEB/Docker 等产物、管理仓库权限时不使用。
|
||||
用户提到旧名 manage-release 时同样使用本 skill。
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: requirement-flow
|
||||
description: >-
|
||||
【已弃用，兼容占位】requirement-flow 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
显式调用门槛：仅在用户显式调用 `/requirement-flow` 或 `$requirement-flow`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。【已弃用，兼容占位】requirement-flow 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
流程，直接读取 ../ship/SKILL.md 并按其执行；本次按 long 模式。复杂需求、跨模块、
|
||||
PRD 批准后开发、拆任务交付都属于 ship。
|
||||
---
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: ship
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/ship` 或 `$ship`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
把一次变更从说明推进到测试、PR、合并、构建或部署。小改动、修 bug、改文案、加按钮
|
||||
直接做；跨模块复杂需求先 specifier 评审 PRD 再拆任务。用户可指定 short 或 long
|
||||
模式。触发词：ship、short-ship、long-ship、short 模式、long 模式、交付、小需求、
|
||||
直接做；跨模块复杂需求先 specifier 评审 PRD 再拆任务。显式调用后可指定 short 或 long
|
||||
模式；范围包括 ship、short-ship、long-ship、short 模式、long 模式、交付、小需求、
|
||||
修 bug、复杂需求、跨模块。已有 PR 用 pr-ship。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
---
|
||||
name: short-ship
|
||||
description: >-
|
||||
【已弃用，兼容占位】short-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
显式调用门槛：仅在用户显式调用 `/short-ship` 或 `$short-ship`，或由已显式调用的上游
|
||||
skill 明确委派时加载；不自动触发。【已弃用，兼容占位】short-ship 已并入 ship。命中本 skill 时不要在此执行任何
|
||||
流程，直接读取 ../ship/SKILL.md 并按其执行；本次按 short 模式。小需求、小改动、
|
||||
修 bug、改文案、加按钮、修复后发 PR 或部署都属于 ship。
|
||||
---
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: specifier
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/specifier` 或 `$specifier`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
把复杂或跨模块需求整理成可评审、可版本化的 HTML PRD，并在用户明确批准某个版本后
|
||||
生成交给 ship 的结构化 handoff。用户说做复杂功能、写 PRD、梳理需求、设计方案、
|
||||
需求评审、反复改需求或交给 ship 开发时使用；小改动、Bug 根因排查和单纯架构讨论
|
||||
生成交给 ship 的结构化 handoff。显式调用后用于复杂功能、写 PRD、梳理需求、设计方案、
|
||||
需求评审、反复改需求或交给 ship 开发；小改动、Bug 根因排查和单纯架构讨论
|
||||
不使用。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
---
|
||||
name: test-preflight
|
||||
description: >-
|
||||
Verify or prepare a mobile/integration test environment from a declared matrix:
|
||||
Explicit invocation gate: load only when the user explicitly invokes `/test-preflight` or `$test-preflight`,
|
||||
or when an already explicitly invoked upstream skill delegates it; never auto-trigger. Verify or prepare a mobile/integration test environment from a declared matrix:
|
||||
artifacts, tester bindings, HOST/PUBLIC_HOST, service probes, and fixture/cleanup
|
||||
contracts. Use before tester runs; it is not a deployment, build, or business-data skill.
|
||||
contracts. Use only after explicit invocation or delegation from `tester`; it is not a deployment, build, or business-data skill.
|
||||
---
|
||||
|
||||
# test-preflight
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
---
|
||||
name: tester
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/tester` 或 `$tester`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
维护并执行项目黑盒测试目录（.pouch/tester）：列出/增改用例，按分类或
|
||||
id 跑脚本、浏览器或移动模拟器；支持用 Orca project id、项目名称或 terminal id
|
||||
定位 Agent 执行环境并创建临时 terminal。触发词：/tester、列出测试、完善测试用例、
|
||||
按分类测、跑 smoke、现场复测；测试环境由本机触发，正式环境由 app00 Agent terminal 委派部署。
|
||||
定位 Agent 执行环境并创建临时 terminal。显式调用后的范围包括：列出测试、完善测试用例、
|
||||
按分类测、跑 smoke 和现场复测；测试环境由本机触发，正式环境由 app00 Agent terminal 委派部署。
|
||||
默认风险最低档；local 配置的 HOST 默认是 127.0.0.1。
|
||||
---
|
||||
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
---
|
||||
name: what-is-it
|
||||
description: 从零解释陌生概念、技术、系统或知识领域，帮助用户建立整体认知框架和可用于独立推理的心智模型，而不只是给出定义或堆砌术语。Use when the user asks “这是什么”“介绍一下”“从零讲解”“帮我建立心智模型”“整体理解某领域”, or explicitly invokes what-is-it. For a narrow factual question or a requested one-sentence definition, answer briefly instead of forcing a full tutorial.
|
||||
description: >-
|
||||
显式调用门槛：仅在用户显式调用 `/what-is-it` 或 `$what-is-it`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。
|
||||
从零解释陌生概念、技术、系统或知识领域，帮助用户建立整体认知框架和可用于独立推理的心智模型，而不只是给出定义或堆砌术语。显式调用后，窄事实问题或一句话定义仍应简短回答。
|
||||
---
|
||||
|
||||
# What Is It — 从零建立心智模型
|
||||
|
||||
Reference in New Issue
Block a user