@netpilot/skills 0.7.0 → 0.9.0

package/skills/to-questionnaire/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: to-questionnaire
+description: 当一项决定依赖另一位知识持有者提供用户自己无法回答的事实或判断，需要生成可异步填写或会议共填的 Markdown questionnaire 时使用。
+disable-model-invocation: true
+---
+
+# To Questionnaire
+
+把用户无法独自回答的事情变成一份 **questionnaire（问卷）**：一份交给某一个人异步填写，或在会议中共同填写的 Markdown 文档。接收者掌握用户缺少的知识；问卷把这些知识提取出来。
+
+**Grill the send, not the subject（盘问发送目的，不盘问待解主题）。** 只访谈用户能够回答的 _send_：发给谁，以及需要拿回什么。文档中的问题再瞄准接收者已知与用户所需之间的 **gap（信息缺口）**。
+
+1. **发给谁？** 在一次交流中询问接收者的角色、专业知识，以及与用户的关系。这决定问卷的语气和需要携带多少背景。完成条件：已经知道接收者是谁，以及对方掌握什么用户不知道的知识。
+
+2. **需要拿回什么？** 在一次交流中询问用户无法独自解决、必须由这个人提供的具体决定或事实。完成条件：已经得到一份具体清单，说明用户在收到回答后必须能够做什么或决定什么。
+
+3. **编写 questionnaire。** 针对步骤 1–2 确定的 gap 起草问题，严格采用下方文档结构。写入当前目录的 `to-questionnaire-<slug>.md`，slug 来自主题，并报告最终路径。目标路径已存在时，选择唯一的新后缀或 slug；不得覆盖已有文件。完成条件：文件已经存在，并且步骤 2 中用户点名的每一项都由一个问题覆盖。
+
+## 文档结构
+
+把文档框定为 **discovery questionnaire（探索问卷）**：用户缺少背景，接收者掌握它。按 **most-important-first（最重要的问题优先）**排列问题——异步填写意味着可能只有一次回答机会。问题多于少量时，再按主题用 `##` 标题分组。使用下面的模板。
+
+<questionnaire-template>
+
+# <问卷标题>
+
+**目的：** 为什么需要这份问卷，以及哪个决定取决于它。
+
+**发起人：** <用户> — **接收者：** <接收者> — **回答用途：** <回答会用于哪里>
+
+## 背景
+
+用一个段落帮助没有参与用户思考过程的接收者了解背景。提供足以高质量回答的信息，但不要写成一页背景资料。
+
+## 如何回答
+
+写明截止时间与大致投入。部分回答和“我不知道”都有价值；对不确定的内容显式标记，而不是跳过。
+
+## <主题标题>
+
+每个主题一个 `##` 章节，下面按 most-important-first 排列问题。每个问题只问一件事，不把多个问题合在一起；紧接一个作答占位。只有问题可能被误解或招致敷衍回答时，才添加一行“为什么重要”。
+
+<question-example>
+
+### 系统在首次发布时预计要承受多大负载？
+
+_为什么重要：这决定现在就为突发流量预留容量，还是推迟该投入。_
+
+>
+
+</question-example>
+
+## 还有其他信息吗？
+
+用一个兜底问题收尾：还有什么我们没有问、但应该知道的事情？
+
+</questionnaire-template>

package/skills/to-questionnaire/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "To Questionnaire"
+  short_description: "为掌握关键信息的人生成可异步填写的结构化问卷并覆盖全部决策缺口"
+  default_prompt: "请使用 $to-questionnaire 询问问卷的收件人与信息缺口，并生成可异步填写的 Markdown。"
+policy:
+  allow_implicit_invocation: false

package/skills/to-spec/SKILL.md

@@ -19,7 +19,7 @@ disable-model-invocation: true
 1. 若尚未完成，探索仓库当前状态。全文使用项目 glossary 的 canonical terms，并遵守相关 ADR。
 2. 草拟测试 feature 的 Seams：
    - 优先复用现有 Seam；
-   - 必须增加时，尽可能放在最高层；
+   - 无论复用还是新增，都尽可能使用最高层的 Seam；
    - Seam 越少越好，理想情况只有一个。
 
    向用户校准这些 Seams 是否符合预期。这是规格发布前的定向确认，不重新开始需求访谈。
@@ -27,23 +27,25 @@ disable-model-invocation: true
 
 ## Spec 结构
 
-### Problem Statement
+### 问题陈述（Problem Statement）
 
 从用户视角描述其面对的问题。
 
-### Solution
+### 解决方案（Solution）
 
 从用户视角描述解决方案。
 
-### User Stories
+### 用户故事（User Stories）
 
 使用足够详尽的编号列表覆盖所有用户可观察行为；每条都能独立检查，合在一起覆盖 feature 的全部方面：
 
 ```text
-1. As a <actor>, I want a <feature>, so that <benefit>.
+1. 作为<角色>，我希望<功能>，以便<收益>。
 ```
 
-### Implementation Decisions
+例如：作为手机银行客户，我希望查看各账户余额，以便作出更有依据的消费决策。
+
+### 实施决定（Implementation Decisions）
 
 记录已经形成的实施决定，包括：
 
@@ -58,7 +60,7 @@ disable-model-invocation: true
 
 不要写具体文件路径或工作代码，它们很快会过时。唯一例外：prototype 产生的 state machine、reducer、schema 或 type shape 比文字更精确时，可以只嵌入承载 decision 的最小片段，并注明来自 prototype。
 
-### Testing Decisions
+### 测试决定（Testing Decisions）
 
 至少说明：
 
@@ -66,15 +68,15 @@ disable-model-invocation: true
 - 哪些 Modules / Seams 要测试；
 - 代码库中可复用的同类测试先例。
 
-### Acceptance Criteria
+### 验收标准（Acceptance Criteria）
 
 用可观察、可验证的条件定义完成。适合时使用 Given / When / Then；不要把“修改某文件”当作用户行为的验收条件。
 
-### Out of Scope
+### 范围外事项（Out of Scope）
 
 明确与当前 spec 相邻但不包含的事项。
 
-### Further Notes
+### 补充说明（Further Notes）
 
 只放无法归入以上章节、但实施者确实需要的补充信息；没有内容时省略。
 

package/skills/to-tickets/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 
 # To Tickets
 
-把 plan、spec 或当前对话拆成一组 **tracer-bullet vertical slices**。每个 ticket 都声明阻塞它的 **blocking edges**。
+把 plan、spec 或当前对话拆成一组 **tracer-bullet vertical slices（曳光弹式垂直切片）**。每个 ticket 都声明阻塞它的 **blocking edges（阻塞关系）**。
 
 ## 动作授权
 
@@ -37,7 +37,7 @@ disable-model-invocation: true
 - 能在一个新鲜上下文窗口中完成；
 - 声明真正阻塞它的 tickets；没有 blockers 的 ticket 可立即开始。
 
-**Wide refactor 是垂直切片的例外。** 识别信号不是“改动文件很多”，而是一次不可避免的机械变化——例如 **rename a column** 或 **retype a shared symbol**——会同时打破大量调用点，使普通垂直切片无法先 green。此时使用 **expand–migrate–contract**：
+**Wide refactor（大范围重构）是垂直切片的例外。** 识别信号不是“改动文件很多”，而是一次不可避免的机械变化——例如 **rename a column** 或 **retype a shared symbol**——会同时打破大量调用点，使普通垂直切片无法先 green。此时使用 **expand–migrate–contract**：
 
 1. **Expand**：让新旧形式并存，不破坏现有调用者；
 2. **Migrate**：按 package、目录或其他 blast-radius 边界拆成批次，每批一个 ticket，均被 expand 阻塞，并保持每批 CI green；

package/skills/triage/SKILL.md

@@ -28,18 +28,18 @@ disable-model-invocation: true
 
 执行前用一句话列出拟进行的状态变化和写入，无需再次确认。
 
-若只是“triage 这个 item”但最终状态仍需维护者判断，先给 recommendation 并等待。bare number 无法唯一解析、label mapping 不明或状态冲突时，只读检查并询问。
+若只是“triage 这个 item”但最终状态仍需维护者判断，先给建议并等待。裸编号无法唯一解析、label mapping 不明或状态冲突时，只读检查并询问。
 
 永不自动 push、创建 PR、merge、deploy 或发布。若 `.out-of-scope/` 更新需要 commit，只能在明确本地 branch 上提交；不自动 push。
 
 ## 分类与状态
 
-两个 category：
+两个 category（类别）：
 
 - **bug**：已有行为损坏；
 - **enhancement**：新增功能或改进。
 
-五个 state：
+五个 state（状态）：
 
 - **needs-triage**：等待维护者评估；
 - **needs-info**：等待 reporter 补充；
@@ -62,7 +62,7 @@ state labels 冲突时停止写入，先请求维护者决定。
 
 ## 模式一：显示需要关注的内容
 
-按最旧优先查询三个 bucket：
+按最旧优先查询三个分组：
 
 1. unlabeled；
 2. needs-triage；
@@ -70,7 +70,7 @@ state labels 冲突时停止写入，先请求维护者决定。
 
 若 tracker 配置把外部 PR 纳入 triage，发现列表只包含外部作者 PR，并标记 `[PR]` 或 `[issue]`。显式指定的 PR 不受该发现过滤限制。
 
-输出每个 bucket 的数量与每项一行摘要，让维护者选择。
+输出每个分组的数量与每项一行摘要，让维护者选择。
 
 ## 模式二：Triage 一个 item
 
@@ -82,8 +82,8 @@ state labels 冲突时停止写入，先请求维护者决定。
 
 执行两项代码库检查：
 
-- **Redundancy**：按领域概念搜索现有实现，而不只搜索 reporter 原话，并说明查过哪里。已实现则进入 wontfix，但不写 `.out-of-scope/`。
-- **Prior rejection**：读取 `.out-of-scope/*.md`，按概念相似性寻找以前的拒绝。
+- **Redundancy（重复需求）**：按领域概念搜索现有实现，而不只搜索 reporter 原话，并说明查过哪里。已实现则进入 wontfix，但不写 `.out-of-scope/`。
+- **Prior rejection（已有拒绝决定）**：读取 `.out-of-scope/*.md`，按概念相似性寻找以前的拒绝。
 
 ### 给出建议
 
@@ -112,7 +112,7 @@ state labels 冲突时停止写入，先请求维护者决定。
 
 请求仍缺关键决定时调用 `$grilling`；术语、状态或不变量需要沉淀时同时调用 `$domain-modeling`。
 
-一次一个问题。已确认内容写入 triage notes，后续 session 不重问。
+每一轮询问当前全部已解锁的 frontier；本轮尚未解决的依赖留到下一轮。已确认内容写入 triage notes，后续 session 不重问。
 
 ### 应用结果
 
@@ -167,5 +167,5 @@ state labels 冲突时停止写入，先请求维护者决定。
 1. 读取已确认内容和未答问题；
 2. 检查 reporter 后续回复；
 3. 标出哪些问题已解决；
-4. 展示更新后的 picture；
+4. 展示更新后的全貌；
 5. 只询问仍未解决的问题。

package/skills/wait-what/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: wait-what
+description: 当用户表示上一条消息没有听懂、没有讲清楚，或显式要求 wait-what 时，用缺失上下文和项目术语重新讲述上一条消息。
+disable-model-invocation: true
+---
+
+等等——上一条没有讲清楚。重新讲一遍：补一点上下文；使用当前沟通语言的短句和单义技术词，英语时采用 ASD-STE100 Simplified Technical English（简化技术英语）；优先使用项目的统一领域语言，多 context 仓库先沿 `CONTEXT-MAP.md` 找到对应的 `CONTEXT.md`，单 context 仓库直接读取 `CONTEXT.md`，不存在时使用已经确认的项目词汇，不杜撰文档内容。

package/skills/wait-what/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Wait What"
+  short_description: "用当前语言和项目术语重新讲清上一条没有讲明白的消息"
+  default_prompt: "请使用 $wait-what 补足必要上下文，并用更简明的当前语言重述上一条消息。"
+policy:
+  allow_implicit_invocation: false

package/skills/wayfinder/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 
 # Wayfinder
 
-Wayfinding 的目标是找到通往 **Destination** 的路，不是冲向 Destination。命名 Destination 是建图的第一项动作，因为它会塑造每一张 ticket。Destination 可能是交给后续流程迭代的明确 spec、规划前尚待锁定的 decision，或在当前 effort 原地完成的 migration。Map 不限定领域：工程、课程内容或其他超过单会话且仍在 fog of war 中的工作都可以使用。
+Wayfinding 的目标是找到通往 **Destination（目的地）** 的路，不是冲向 Destination。命名 Destination 是建图的第一项动作，因为它会塑造每一张 ticket。Destination 可能是交给后续流程迭代的明确 spec、规划前尚待锁定的 decision，或在当前 effort 原地完成的 migration。Map 不限定领域：工程、课程内容或其他超过单会话且仍在 fog of war 中的工作都可以使用。
 
 地图由 decision tickets 组成：每票解决一个问题，产物是 decision，而不是 build slice。Destination 是 spec 时，路线清楚后默认交给 `$to-spec`；Destination 本身是 decision 或 Notes 明确允许原地 migration 时，按该 Destination 的完成条件结束，不机械转成 spec。
 
@@ -44,9 +44,9 @@ Wayfinding 的目标是找到通往 **Destination** 的路，不是冲向 Destin
 
 Map 是一个标记为 `wayfinder:map` 的 tracker item，也是 canonical artifact。远程 tracker 使用 parent/child issue；本地 fallback 使用一份 map 文件和每票一个文件。
 
-Map 是索引，不重复保存 ticket 的完整答案。每个 decision 只在其 ticket 的 resolution 中存在；map 只写一句 gist 并链接。
+Map 是索引，不重复保存 ticket 的完整答案。每个 decision 只在其 ticket 的 resolution 中存在；map 只写一句摘要并链接。
 
-Map body 是每个 session 只加载一次的低分辨率视图。Open tickets 不列在 body 中，而是通过 child-ticket query 获取。
+Map body 是每个 session 只加载一次的低分辨率概览。Open tickets 不列在 body 中，而是通过 child-ticket query 获取。
 
 ```markdown
 ## Destination
@@ -56,7 +56,7 @@ Map body 是每个 session 只加载一次的低分辨率视图。Open tickets
 领域、每个 session 应调用的 skills、常驻约束和权限。
 
 ## Decisions so far
-- [已关闭 ticket 标题](link) — 一行 decision gist
+- [已关闭 ticket 标题](link) — 一行决定摘要
 
 ## Not yet specified
 仍在 scope 内，但尚无法精确表述为问题的 fog。
@@ -87,7 +87,7 @@ Map body 是每个 session 只加载一次的低分辨率视图。Open tickets
 
 - **research**：AFK。当 decision 等待当前工作目录之外的一手知识时使用，读取并返回带来源的事实；普通 repo exploration 不建立 research ticket。
 - **prototype**：HITL。制作低成本 artifact，让人对具体形态或行为作出判断。
-- **grilling**：HITL。调用 `$grilling` 与 `$domain-modeling`，一次一个问题；这是不确定类型时的默认选择。
+- **grilling**：HITL。调用 `$grilling` 与 `$domain-modeling`，以 rounds 询问当前 ticket 内 design tree 的全部 frontier；这是不确定类型时的默认选择。
 - **task**：HITL 或 AFK。完成一个必须先发生、但本身没有 decision 的动作，以解除后续阻塞。Resolution 要记录后续 tickets 依赖的事实，例如 credential location、URL、row count 或完成步骤。
 
 HITL ticket 必须让真人表达自己的判断；agent 不得代替用户回答访谈问题。
@@ -130,26 +130,26 @@ Out of scope 是经过确认的 scope boundary，不是尚未看清的 fog，永
 
 只有 destination 被重新定义时，才将相关内容作为新 effort 重新考虑。
 
-## 调用模式一：Chart the map
+## 调用模式一：绘制地图（Chart the map）
 
 用户以大型模糊想法调用：
 
-1. **Name the destination**
+1. **命名目的地（Name the destination）**
    调用 `$grilling` 和 `$domain-modeling`，明确 map 最终要找到什么。它们返回 destination、scope 和统一术语。
 
-2. **Breadth-first map the frontier**
+2. **广度优先绘制 frontier**
    再次访谈，但横向扫描整个空间，寻找当前可精确表达的 decisions 与仍在 fog 中的区域。不要过早深入单一分支。
 
 3. **检查是否真的需要 map**
    如果没有 fog，且全部工作可在一个 session 中解释清楚，停止建图，告诉用户应进入 `$to-spec` 或 `$implement`。
 
-4. **Create the map**
+4. **创建地图**
    填写 Destination、Notes、空的 Decisions so far、Not yet specified 和 Out of scope。
 
-5. **Create then wire tickets**
+5. **先创建票据，再连接依赖**
    先创建所有当前可定义的 child tickets，拿到真实标识符后，第二 pass 再建立 blocking。不能在创建前猜 id。
 
-6. **Fire research tickets**
+6. **启动研究票据**
    research tickets 可以并行：
    - 为每票创建隔离 worktree/本地 branch；
    - 调用 `$research` 写带引用的 Markdown artifact；
@@ -159,14 +159,14 @@ Out of scope 是经过确认的 scope boundary，不是尚未看清的 fog，永
    - 关闭 research ticket并更新 map。
    不得自动 push branch。
 
-7. **Stop**
+7. **停止**
    Charting session 不手工解决 grilling、prototype 或 task ticket。
 
-## 调用模式二：Work through the map
+## 调用模式二：逐票推进地图（Work through the map）
 
 用户提供 map URL、编号或本地路径。ticket 参数可选。
 
-1. 加载 map 的低分辨率视图，不一次读取所有 ticket body。
+1. 加载 map 的低分辨率概览，不一次读取所有 ticket body。
 2. 用户指定 ticket 时使用它；否则选择第一个 frontier ticket。
 3. 在工作前 claim。
 4. 按 type 解决，并调用 map `Notes` 中点名的 skills；未指定且不确定时默认使用 `$grilling` + `$domain-modeling`：
@@ -174,11 +174,11 @@ Out of scope 是经过确认的 scope boundary，不是尚未看清的 fog，永
    - prototype → `$prototype`；
    - grilling → `$grilling` + `$domain-modeling`；
    - task → 完成解除 decision blocker 所需的最小动作。
-5. 需要时再 zoom：按需读取相关 open/closed ticket 全文。
+5. 需要时再展开细节：按需读取相关 open/closed ticket 全文。
 6. 记录 resolution：
    - 写 resolution comment；
    - 关闭 ticket；
-   - 在 Decisions so far 追加标题链接与一行 gist。
+   - 在 Decisions so far 追加标题链接与一行摘要。
 7. 更新地图：
    - create then wire 新 ticket；
    - 把已变得可精确表达的 fog 转为 ticket，并从 Not yet specified 删除；

package/skills/wizard/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: wizard
+description: 为必须由用户完成的控制台操作、凭证录入或一次性迁移生成交互式 Bash 向导；仅在存在人工步骤时使用，agent 能自行完成的操作不转交给用户。生成脚本不等于执行脚本或授权外部写入。
+---
+
+# Wizard
+
+**Wizard（交互式向导）** 是分阶段引导人完成手工流程的 Bash 脚本：打开 URL，说明点击和复制位置，接收输入，把值写到明确目标，在必要动作前确认，并显示剩余阶段。它可以帮助配置第三方服务、执行一次性迁移，或从一个已知状态转到另一个状态。
+
+[template.sh](template.sh) 已提供公共 library：阶段进度、清屏、确认、跨平台打开 URL（含 WSL）、隐藏秘密输入、`.env` 幂等 upsert、GitHub secret/variable 写入和结束摘要。**生成向导时，只确定流程并编写阶段，保持 `STAGES` 标记以上的 library 不变。**
+
+向导默认是一次性产物，保存在明确的 scratch 或 `scripts/` 路径。任务结束时说明哪些文件可清理；删除须有目标明确的授权。只有用户要求可重复运行的项目配置路径时才建议保留到仓库；commit、远程写入及不可逆动作分别遵守当前授权。
+
+## 1. 确定人工流程
+
+先读仓库，不把可以查明的事实交给用户：
+
+- 配置任务：`.env.example`、`.env*` 的键名和格式、README、`docker-compose*`、框架配置、`.github/workflows/*` 中的每个 `secrets.*` / `vars.*` 引用。只识别所需值与去向，不把已有秘密读入对话或日志。
+- 迁移任务：当前状态、目标状态、不可逆动作及哪些步骤可重复。配置 upsert 可重跑，不表示迁移命令也幂等。
+- 执行环境：Bash 与必要系统工具；Windows 使用已安装的 Git Bash 或 WSL，不能把存在 `bash.exe` 当成可运行证明。没有可用 Bash 时说明限制，协商等价交付形式，不自动安装运行环境。
+
+向用户展示按顺序排列的阶段、每阶段产生的值和写入位置，等待确认；用户可增删或重排阶段。既有授权可复用，但只授权生成脚本时不运行它。需要 GitHub 写入时，明确 `[host/]owner/repo`，由阶段代码设置 `GH_REPO`，不从运行时工作目录猜目标。
+
+完成条件：每个阶段已命名并排序；每个值的来源、目标（`.env`、GitHub、两者或不保存）和是否为秘密都已明确；没有凭证的纯操作阶段也已标出。
+
+## 2. 描述每个阶段的路径
+
+写清楚打开哪个 URL、点击什么、在哪里取得哪个值、填入哪个变量，例如“Dashboard → Developers → API keys → Reveal test key → 复制”。不知道当前 UI 或精确命令时查一手文档，必要时向用户确认；保留界面实际显示的英文名称，说明用中文。
+
+完成条件：每个阶段都有陌生人也能照做的具体路径，尚未核实的步骤明确列为阻塞。
+
+## 3. 编写向导
+
+把模板复制到不覆盖既有文件的目标路径，替换示例，按依赖顺序每步一个 `stage`。复用 `stage`、`say` / `step`、`open_url`、`ask` / `ask_secret`、`write_env`、`set_secret` / `set_var`、`pause` / `confirm`；`TOTAL_STAGES` 与真实阶段数一致。示例中的服务只是演示，不自动成为用户的选择。
+
+先打开 URL，再询问该页面上的值；秘密使用 `ask_secret`，认证留在用户浏览器中，URL 不携带秘密。持久化 `.env` 值使用 `write_env`，CI 只接收实际引用的值。`set_secret` / `set_var` 会确认明确仓库；不可逆操作也必须置于实际控制流门禁后，例如 `confirm "执行已说明的不可逆动作？" || exit 1`，不能只打印提醒然后继续执行。
+
+每个阶段只承载一个聚焦任务，清屏后仍能看见该任务所需说明。界面只有人能操作的部分交给人；能够安全调用的 API、CLI 或本地检查由 agent 在已授权范围完成。
+
+模板只处理单行 `KEY=value` 的 dotenv 文件：保留空行、整行注释与其他键；支持可准确往返的普通单引号或双引号值。复杂转义、行尾注释、多行值、混合引号组合或符号链接目标会拒绝写入。遇到这些格式，使用项目已认可的配置工具或把该阶段改为明确的人工配置；不得丢弃字符来“修复”凭证，也不得 `source` 不可信 `.env`。写入会以 `mktemp` 文件替换目标，不保证保留原 owner、mode 或 ACL；需要其他服务用户读取的共享配置，应使用项目认可的权限管理工具。运行前核对执行用户与实际读取者的权限，并确保没有其他进程同时编辑该配置；模板不提供多文件事务或并发写入保证。
+
+完成条件：阶段顺序、计数和每个值的去向与已确认流程一致；每个不可逆动作和 GitHub 写入都受实际确认门禁控制；重新运行不会盲目重复已完成的非幂等动作。
+
+## 4. 验证并交接
+
+- 执行 `bash -n <script>`；`shellcheck` 可用时运行，并如实记录缺失。
+- POSIX 环境执行 `chmod +x <script>`；也可以交付明确的 `bash <script>` 命令。
+- agent 不端到端运行生成的真实向导：它会打开浏览器、等待人输入并可能产生外部动作。静态追踪每个值是否到达步骤 1 指定的目标，每个 CI secret 名称是否精确对应 `secrets.*` 引用。
+- 用户要求可重复使用时，按现有授权保存并在项目 README 链接；未授权 commit 时只留下可审查改动。
+
+完成条件：返回脚本绝对路径、执行命令、已执行检查及结果、未验证的人工步骤；有 skipped 或未确认写入时明确列出，不能声称目标状态已全部达成。用户执行后返回结束摘要与脱敏观察结果，调用方据此恢复原任务；不索要原始凭证。

package/skills/wizard/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Wizard"
+  short_description: "生成供用户执行的分阶段人工操作向导，明确输入、写入目标和验证证据"
+  default_prompt: "请使用 $wizard 为必须由我操作的步骤生成可运行向导，并先列出阶段和数据去向。"
+policy:
+  allow_implicit_invocation: true