From f4f698050f06feac19056db0e223c2f85ee46154 Mon Sep 17 00:00:00 2001 From: laily Date: Wed, 11 Nov 2026 14:32:45 +0800 Subject: [PATCH] feat: update --- skills/_template/SKILL.md | 9 +++++---- skills/ack/SKILL.md | 3 ++- skills/agent-runtime/SKILL.md | 3 ++- skills/android-tester/SKILL.md | 7 ++++--- skills/bugfix-ship/SKILL.md | 3 ++- skills/builder/SKILL.md | 5 +++-- skills/declarative-openspec-loop/SKILL.md | 4 +++- skills/delivery-loop/SKILL.md | 1 + skills/deployer/SKILL.md | 5 +++-- skills/discussion-notes/SKILL.md | 6 +++--- skills/draw-prototype-flow/SKILL.md | 7 ++++--- skills/eli5/SKILL.md | 6 +++--- skills/fixds/SKILL.md | 4 ++-- skills/host-sec-check/SKILL.md | 3 ++- skills/ios-tester/SKILL.md | 5 +++-- skills/knowledge-explainer/SKILL.md | 3 ++- skills/long-ship/SKILL.md | 3 ++- skills/manage-release/SKILL.md | 3 ++- skills/memory-distill/SKILL.md | 10 +++++----- skills/note-style/SKILL.md | 4 +++- skills/orc/SKILL.md | 5 +++-- skills/pouch/SKILL.md | 5 +++-- skills/pr-ship/SKILL.md | 3 ++- skills/previewer/SKILL.md | 3 ++- skills/product-prototype/SKILL.md | 16 +++++++++------- skills/product-prototype/references/artifacts.md | 3 +++ skills/product-prototype/references/commands.md | 14 ++++++++++++++ skills/releaser/SKILL.md | 3 ++- skills/requirement-flow/SKILL.md | 3 ++- skills/ship/SKILL.md | 5 +++-- skills/short-ship/SKILL.md | 3 ++- skills/specifier/SKILL.md | 5 +++-- skills/test-preflight/SKILL.md | 5 +++-- skills/tester/SKILL.md | 5 +++-- skills/what-is-it/SKILL.md | 4 +++- 35 files changed, 113 insertions(+), 63 deletions(-) diff --git a/skills/_template/SKILL.md b/skills/_template/SKILL.md index 8ad229f..a2198dd 100644 --- a/skills/_template/SKILL.md +++ b/skills/_template/SKILL.md @@ -1,7 +1,8 @@ --- name: skill-name description: >- - 简要描述 skill 做什么、何时触发。写入用户可能使用的触发表达，让 Agent 能自动匹配。 + 显式调用门槛：仅在用户显式调用 `/` 或 `$`，或由已显式调用的上游 + skill 明确委派时加载；不自动触发。简要描述 skill 做什么，以及显式调用后的使用范围。 --- # Skill 名称 @@ -10,10 +11,10 @@ description: >- --- -## 何时使用 +## 显式调用后的适用范围 -- 触发场景 1 -- 触发场景 2 +- 显式调用后的场景 1 +- 显式调用后的场景 2 ## 不适用 diff --git a/skills/ack/SKILL.md b/skills/ack/SKILL.md index 1dad70f..3369c91 100644 --- a/skills/ack/SKILL.md +++ b/skills/ack/SKILL.md @@ -1,7 +1,8 @@ --- name: ack description: >- - 初始化、检查并运行 ACK 三角色闭环。仅在用户显式调用 /ack 或 $ack，并要求 + 显式调用门槛：仅在用户显式调用 `/ack` 或 `$ack`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 + 初始化、检查并运行 ACK 三角色闭环。显式调用后可要求 初始化 ACK、检查 .pouch/ack、按 ACK 做需求或修 bug、指挥 Coordinator/Developer/Test、配置或运行测试环境与发版、或跑回归时使用。 --- diff --git a/skills/agent-runtime/SKILL.md b/skills/agent-runtime/SKILL.md index 9a19d12..2107116 100644 --- a/skills/agent-runtime/SKILL.md +++ b/skills/agent-runtime/SKILL.md @@ -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 闭环。 --- diff --git a/skills/android-tester/SKILL.md b/skills/android-tester/SKILL.md index 683a366..63e4b4d 100644 --- a/skills/android-tester/SKILL.md +++ b/skills/android-tester/SKILL.md @@ -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 diff --git a/skills/bugfix-ship/SKILL.md b/skills/bugfix-ship/SKILL.md index bf94875..d629efa 100644 --- a/skills/bugfix-ship/SKILL.md +++ b/skills/bugfix-ship/SKILL.md @@ -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。 --- diff --git a/skills/builder/SKILL.md b/skills/builder/SKILL.md index 7269e31..5bb0ca4 100644 --- a/skills/builder/SKILL.md +++ b/skills/builder/SKILL.md @@ -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 仅用户点名镜像时才走。 --- diff --git a/skills/declarative-openspec-loop/SKILL.md b/skills/declarative-openspec-loop/SKILL.md index cc18c50..83ea5e1 100644 --- a/skills/declarative-openspec-loop/SKILL.md +++ b/skills/declarative-openspec-loop/SKILL.md @@ -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 循环 diff --git a/skills/delivery-loop/SKILL.md b/skills/delivery-loop/SKILL.md index ca21cc4..be34687 100644 --- a/skills/delivery-loop/SKILL.md +++ b/skills/delivery-loop/SKILL.md @@ -1,6 +1,7 @@ --- name: delivery-loop description: >- + 显式调用门槛：仅在用户显式调用 `/delivery-loop` 或 `$delivery-loop`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 为修复、PR 和需求任务提供可配置的验证、发 PR、合并、回归、构建、发布与部署状态机。 仅作为 ship、pr-ship 的共享执行规则使用。 --- diff --git a/skills/deployer/SKILL.md b/skills/deployer/SKILL.md index 32532e7..2619981 100644 --- a/skills/deployer/SKILL.md +++ b/skills/deployer/SKILL.md @@ -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 diff --git a/skills/discussion-notes/SKILL.md b/skills/discussion-notes/SKILL.md index c6a2b16..e15d87e 100644 --- a/skills/discussion-notes/SKILL.md +++ b/skills/discussion-notes/SKILL.md @@ -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. --- diff --git a/skills/draw-prototype-flow/SKILL.md b/skills/draw-prototype-flow/SKILL.md index ba906c5..0783584 100644 --- a/skills/draw-prototype-flow/SKILL.md +++ b/skills/draw-prototype-flow/SKILL.md @@ -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、纯技术架构图或单张插画。 --- diff --git a/skills/eli5/SKILL.md b/skills/eli5/SKILL.md index 5fa135d..13b76ed 100644 --- a/skills/eli5/SKILL.md +++ b/skills/eli5/SKILL.md @@ -1,9 +1,9 @@ --- name: eli5 description: >- - 用大图少字的单页 HTML 把话题讲给完全没背景的人听。Use when the user types - /eli5 , says eli5, 像五岁小孩一样解释, 用小学生能懂的方式讲, 画图解释, - or asks for a dead-simple picture explainer of how something works. + 显式调用门槛：仅在用户显式调用 `/eli5` 或 `$eli5`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 + 用大图少字的单页 HTML 把话题讲给完全没背景的人听。显式调用后处理指定 topic， + 并提供一眼能看懂的图解，而不是聊天长文。 --- # eli5 diff --git a/skills/fixds/SKILL.md b/skills/fixds/SKILL.md index 3f84ef3..88fc97a 100644 --- a/skills/fixds/SKILL.md +++ b/skills/fixds/SKILL.md @@ -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 行为约束 diff --git a/skills/host-sec-check/SKILL.md b/skills/host-sec-check/SKILL.md index 3bfad97..7c91d03 100644 --- a/skills/host-sec-check/SKILL.md +++ b/skills/host-sec-check/SKILL.md @@ -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 diff --git a/skills/ios-tester/SKILL.md b/skills/ios-tester/SKILL.md index 237027b..e4dfbf5 100644 --- a/skills/ios-tester/SKILL.md +++ b/skills/ios-tester/SKILL.md @@ -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 diff --git a/skills/knowledge-explainer/SKILL.md b/skills/knowledge-explainer/SKILL.md index 3e2f7d5..640b132 100644 --- a/skills/knowledge-explainer/SKILL.md +++ b/skills/knowledge-explainer/SKILL.md @@ -1,7 +1,8 @@ --- name: knowledge-explainer description: >- - 把复杂概念、原理、术语和资料讲给没有背景的读者听，先建立直觉，再解释机制、例子和边界。适用于“科普一下”“这是什么”“为什么会这样”“怎么运作”“讲得通俗一点”“帮我理解这篇资料”等请求；不负责单纯校对、翻译或只做格式整理。 + 显式调用门槛：仅在用户显式调用 `/knowledge-explainer` 或 `$knowledge-explainer`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 + 把复杂概念、原理、术语和资料讲给没有背景的读者听，先建立直觉，再解释机制、例子和边界；不负责单纯校对、翻译或只做格式整理。 --- # 知识科普 diff --git a/skills/long-ship/SKILL.md b/skills/long-ship/SKILL.md index acd7342..cbc1234 100644 --- a/skills/long-ship/SKILL.md +++ b/skills/long-ship/SKILL.md @@ -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。 --- diff --git a/skills/manage-release/SKILL.md b/skills/manage-release/SKILL.md index 33fec1b..f20648c 100644 --- a/skills/manage-release/SKILL.md +++ b/skills/manage-release/SKILL.md @@ -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。 --- diff --git a/skills/memory-distill/SKILL.md b/skills/memory-distill/SKILL.md index 6126bc2..2dcf6b9 100644 --- a/skills/memory-distill/SKILL.md +++ b/skills/memory-distill/SKILL.md @@ -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. --- diff --git a/skills/note-style/SKILL.md b/skills/note-style/SKILL.md index b981c5a..b6cbdb2 100644 --- a/skills/note-style/SKILL.md +++ b/skills/note-style/SKILL.md @@ -1,6 +1,8 @@ --- name: note-style -description: 将现有材料整理、压缩或改写为可长期查阅的知识笔记，采用教科书、技术手册或标准说明文风格，并保留事实、公式、适用条件、安全警告和参考资料。适用于用户要求整理 Obsidian 笔记、消除聊天或 AI 写作痕迹、减少重复和空话、统一术语与技术表达，或将技术原理、操作方案改写为结构化知识文档的任务。 +description: >- + 显式调用门槛：仅在用户显式调用 `/note-style` 或 `$note-style`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 + 将现有材料整理、压缩或改写为可长期查阅的知识笔记，采用教科书、技术手册或标准说明文风格，并保留事实、公式、适用条件、安全警告和参考资料。 --- # 整理知识笔记 diff --git a/skills/orc/SKILL.md b/skills/orc/SKILL.md index 441022d..a963440 100644 --- a/skills/orc/SKILL.md +++ b/skills/orc/SKILL.md @@ -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 编排时使用。 --- diff --git a/skills/pouch/SKILL.md b/skills/pouch/SKILL.md index 3a1a216..226e4eb 100644 --- a/skills/pouch/SKILL.md +++ b/skills/pouch/SKILL.md @@ -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 工作流 diff --git a/skills/pr-ship/SKILL.md b/skills/pr-ship/SKILL.md index 916e5ff..e1b1e52 100644 --- a/skills/pr-ship/SKILL.md +++ b/skills/pr-ship/SKILL.md @@ -1,8 +1,9 @@ --- name: pr-ship description: >- + 显式调用门槛：仅在用户显式调用 `/pr-ship` 或 `$pr-ship`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 处理已有 PR/MR：检查差异、审核和 CI，必要时修复阻塞项，合并后以合并 commit 做完整回归， - 再按配置构建、发布和部署。用户说处理、合并、回归或发布 PR 时使用。 + 再按配置构建、发布和部署。显式调用后用于处理、合并、回归或发布 PR。 --- # PR Ship：合并后的完整交付 diff --git a/skills/previewer/SKILL.md b/skills/previewer/SKILL.md index 3476204..d44ef01 100644 --- a/skills/previewer/SKILL.md +++ b/skills/previewer/SKILL.md @@ -1,8 +1,9 @@ --- name: previewer description: >- + 显式调用门槛：仅在用户显式调用 `/previewer` 或 `$previewer`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 用 Node 将已有 HTML、PRD、报告、截图或其它静态文件提供为 HTTP 预览。 - 用户说“把这个 HTML 渲染出来”“预览这个文件”“给我预览 URL”时使用； + 显式调用后用于“把这个 HTML 渲染出来”“预览这个文件”或“给我预览 URL”； 不生成页面内容，不执行构建，不配置代理、隧道或动态业务服务。 --- diff --git a/skills/product-prototype/SKILL.md b/skills/product-prototype/SKILL.md index c1d8ede..4315a6a 100644 --- a/skills/product-prototype/SKILL.md +++ b/skills/product-prototype/SKILL.md @@ -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 服务，必须明确报告为未完成，不能用本地文件路径替代。 diff --git a/skills/product-prototype/references/artifacts.md b/skills/product-prototype/references/artifacts.md index 7504d23..1e39603 100644 --- a/skills/product-prototype/references/artifacts.md +++ b/skills/product-prototype/references/artifacts.md @@ -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/` diff --git a/skills/product-prototype/references/commands.md b/skills/product-prototype/references/commands.md index 4ba2809..3ecaf77 100644 --- a/skills/product-prototype/references/commands.md +++ b/skills/product-prototype/references/commands.md @@ -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。 diff --git a/skills/releaser/SKILL.md b/skills/releaser/SKILL.md index 4a285d9..65f32f4 100644 --- a/skills/releaser/SKILL.md +++ b/skills/releaser/SKILL.md @@ -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。 diff --git a/skills/requirement-flow/SKILL.md b/skills/requirement-flow/SKILL.md index 67d91d8..0314769 100644 --- a/skills/requirement-flow/SKILL.md +++ b/skills/requirement-flow/SKILL.md @@ -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。 --- diff --git a/skills/ship/SKILL.md b/skills/ship/SKILL.md index 7c95d3a..6a1e95a 100644 --- a/skills/ship/SKILL.md +++ b/skills/ship/SKILL.md @@ -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。 --- diff --git a/skills/short-ship/SKILL.md b/skills/short-ship/SKILL.md index 142f5d9..a5374d2 100644 --- a/skills/short-ship/SKILL.md +++ b/skills/short-ship/SKILL.md @@ -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。 --- diff --git a/skills/specifier/SKILL.md b/skills/specifier/SKILL.md index 73b0cb8..9f4073c 100644 --- a/skills/specifier/SKILL.md +++ b/skills/specifier/SKILL.md @@ -1,9 +1,10 @@ --- name: specifier description: >- + 显式调用门槛：仅在用户显式调用 `/specifier` 或 `$specifier`，或由已显式调用的上游 skill 明确委派时加载；不自动触发。 把复杂或跨模块需求整理成可评审、可版本化的 HTML PRD，并在用户明确批准某个版本后 - 生成交给 ship 的结构化 handoff。用户说做复杂功能、写 PRD、梳理需求、设计方案、 - 需求评审、反复改需求或交给 ship 开发时使用；小改动、Bug 根因排查和单纯架构讨论 + 生成交给 ship 的结构化 handoff。显式调用后用于复杂功能、写 PRD、梳理需求、设计方案、 + 需求评审、反复改需求或交给 ship 开发；小改动、Bug 根因排查和单纯架构讨论 不使用。 --- diff --git a/skills/test-preflight/SKILL.md b/skills/test-preflight/SKILL.md index 03fa5ef..d5ab478 100644 --- a/skills/test-preflight/SKILL.md +++ b/skills/test-preflight/SKILL.md @@ -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 diff --git a/skills/tester/SKILL.md b/skills/tester/SKILL.md index fd90440..e7a112b 100644 --- a/skills/tester/SKILL.md +++ b/skills/tester/SKILL.md @@ -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。 --- diff --git a/skills/what-is-it/SKILL.md b/skills/what-is-it/SKILL.md index 10a0415..8c45535 100644 --- a/skills/what-is-it/SKILL.md +++ b/skills/what-is-it/SKILL.md @@ -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 — 从零建立心智模型