@zmice/zc 0.2.1 → 0.2.2

package/vendor/packages/toolkit/src/content/commands/start/body.md

@@ -0,0 +1,148 @@
+调用统一任务开始流程。先评估任务，再在固定 workflow 中选路，不直接假定你已经知道该用哪条命令。
+
+## 核心动作
+
+1. 判断任务主类型：产品分析、完整交付、Bug 修复、审查收尾、文档发布、调查摸底
+2. 判断需求清晰度：清晰、部分清晰、模糊
+3. 判断当前阶段：未定义 / 已有 spec / 已有 plan / 正在 build / 待 review / 待收尾
+4. 判断风险等级：`trivial` / `standard` / `high-risk`
+5. 输出推荐 workflow、该 workflow 的默认入口和必要的防护建议
+
+## 固定 workflow
+
+### 1. `product-analysis`
+
+适用：
+
+- 需求还模糊
+- 目标用户、价值、范围或验收标准不稳定
+- 需要先把想法压成可执行方案
+
+默认入口：
+
+- `product-analysis`
+
+### 2. `full-delivery`
+
+适用：
+
+- 已确认要做
+- 准备进入完整交付门控
+- 需要走定义、计划、实现、审查、验证的主线
+
+默认入口：
+
+- `sdd-tdd`
+
+说明：
+
+- `sdd-tdd` 是 `full-delivery` 的 workflow-entry
+- 它不是统一分诊入口
+
+### 3. `bugfix`
+
+适用：
+
+- Bug
+- 失败测试
+- 构建失败
+- 异常行为
+
+默认入口：
+
+- `debug`
+
+### 4. `review-closure`
+
+适用：
+
+- 已有改动
+- 当前重点是审查、反馈处理、分支收尾
+
+默认入口：
+
+- `quality-review`
+
+### 5. `docs-release`
+
+适用：
+
+- 文档、ADR、发布说明
+- 上线准备与发布后同步
+
+默认入口：
+
+- `doc`
+
+### 6. `investigation`
+
+适用：
+
+- 陌生代码库
+- 上下文失焦
+- 需要先做项目理解或技术摸底
+
+默认入口：
+
+- `onboard`
+
+## 路由原则
+
+- 需求模糊、价值与范围未收敛：优先进入 `product-analysis`
+- 已明确要做且需要完整交付：进入 `full-delivery`
+- Bug、异常行为、失败测试：进入 `bugfix`
+- 已完成实现待审查或待响应 review：进入 `review-closure`
+- 重点是文档、ADR、发布与同步：进入 `docs-release`
+- 当前先要理解项目、修复上下文、摸清约束：进入 `investigation`
+
+## 在 workflow 内部的切入点
+
+- `product-analysis`
+  - 主入口：`product-analysis`
+  - 需要先发散想法：`idea`
+  - 需要产品判断：`product-owner`
+  - 需要方案探索：`brainstorming-and-design`
+  - 需要沉淀规格：`spec`
+  - 需要做方案评审：`plan-review`
+- `full-delivery`
+  - 主入口：`sdd-tdd`
+  - 已有 spec：`task-plan`
+  - 已有 plan：`build`
+  - 待审查：`quality-review`
+  - 待验证：`verify`
+- `bugfix`
+  - 主入口：`debug`
+- `review-closure`
+  - 主入口：`quality-review`
+- `docs-release`
+  - 文档优先：`doc`
+  - 发布优先：`ship`
+- `investigation`
+  - 陌生项目：`onboard`
+  - 上下文漂移：`ctx-health`
+  - 需要重新收敛问题：`idea`
+
+## 平台说明
+
+- `start` 是 canonical command，不等于所有平台都有原生同名命令
+- 在 Codex 上，它更适合作为“统一任务开始方式”的自然语言入口
+- 在 Qwen / Qoder 上，可以呈现为更接近命令式的入口文案
+- 当前阶段没有 `zc start` CLI
+
+## 使用方式
+
+直接描述任务即可；如果你已经知道当前阶段，也可以一起说明。`start` 的职责是帮你先选固定 workflow，再给出下一条入口。
+
+### 示例
+
+```text
+开始一个新需求：实现用户登录和刷新 token，先判断该直接进 full-delivery 还是先做 product-analysis
+
+修复一个问题：批量导入时偶发重复数据，先帮我判型并选择流程
+
+我这里需求还比较散，先帮我做 product-analysis，整理成可落地方案
+
+我这里已经有 spec，帮我判断下一步应该进 task-plan 还是 build
+
+审查最近的改动，并告诉我是否还需要 verify 或 ship
+```

package/vendor/packages/toolkit/src/content/commands/start/meta.yaml

@@ -0,0 +1,55 @@
+kind: command
+name: start
+title: 开始
+description: 统一任务开始入口，先评估任务，再在 6 条固定 workflow 中选择合适的路线和默认入口。
+tier: core
+audience: default
+stability: stable
+suggests:
+  - command:product-analysis
+  - agent:product-owner
+  - skill:brainstorming-and-design
+  - command:sdd-tdd
+  - command:spec
+  - command:plan-review
+  - command:task-plan
+  - command:build
+  - command:quality-review
+  - command:verify
+  - command:debug
+  - command:doc
+  - command:ship
+  - command:onboard
+  - command:ctx-health
+  - command:idea
+  - command:guard
+platforms:
+  - qwen
+  - codex
+  - claude
+  - opencode
+workflow_family: intake
+workflow_role: intake-router
+routing_workflows:
+  - product-analysis
+  - full-delivery
+  - bugfix
+  - review-closure
+  - docs-release
+  - investigation
+task_types:
+  - feature
+  - bugfix
+  - review
+  - docs
+  - release
+  - investigation
+platform_exposure:
+  codex: prompt-entry
+  qwen: command-style
+  claude: command-style
+  opencode: command-style
+source:
+  upstream: toolkit-original
+  strategy: curated
+  notes: 本仓库新增的统一任务入口，用于 intake、任务判型，并在 product-analysis、full-delivery、bugfix、review-closure、docs-release、investigation 六条固定 workflow 中选路；其中 product-analysis 由独立 workflow-entry 承接。

package/vendor/packages/toolkit/src/content/commands/task-plan/body.md

@@ -1,32 +1,27 @@
-调用 `planning-and-task-breakdown`，只做计划，不直接写代码。
+这是 `command:start` 之后的 **任务拆解阶段入口**。
 
-## 核心动作
+当 `command:start` 或 `command:spec` 已经把任务边界定义清楚，就从这里接力到 `planning-and-task-breakdown`，只做计划，不直接写代码。
 
-1. 读取规格和相关代码，识别依赖图
+## 当前阶段要做什么
+
+1. 读取规格、相关代码和依赖关系
 2. 用垂直切片拆任务，保证每项都可工作、可测试
 3. 控制改动半径，默认保持小任务、小文件面
 4. 标注依赖、上下文、风险和验证步骤
 5. 明确可并行项，并等待计划确认后再进入实现
 
-## 相关原则
+## 当前阶段的边界
 
 - 计划要服务实现，不做形式化拆分
 - 每个任务都必须能独立验证
-- 先控制复杂度，再谈并行
-
-## 使用方式
+- 先控制复杂度，再谈并行和分派
 
-在 `/task-plan` 后提供 Spec 或需求描述，我会拆解为可执行的原子任务列表。
+## 从这里通常接到哪里
 
-### 示例
+- 计划需要额外评审：进入 `command:plan-review`
+- 计划已经确认：进入 `command:build`
+- 如果发现规格仍有空洞，回到 `command:spec`
 
-```
-# 基于 spec 拆解
-/task-plan 按照 spec.md 的要求拆解文件上传功能的任务
-
-# 直接描述需求
-/task-plan 拆解用户权限管理模块：RBAC 模型、角色分配、菜单权限、数据权限
+## 使用方式
 
-# 大型重构
-/task-plan 规划单体应用拆微服务的任务，优先拆分用户模块和订单模块
-```
+提供已确认的规格或需求描述，我会拆成可执行的原子任务，并指出下一步该进入评审还是实现。

package/vendor/packages/toolkit/src/content/commands/task-plan/meta.yaml

@@ -13,7 +13,18 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
+workflow_family: lifecycle
+workflow_role: stage-entry
+task_types:
+  - feature
+  - bugfix
+platform_exposure:
+  codex: prompt-entry
+  qwen: command-style
+  claude: command-style
+  opencode: command-style
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/commands/ui/meta.yaml

@@ -13,7 +13,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: toolkit-original
   strategy: curated

package/vendor/packages/toolkit/src/content/commands/verify/body.md

@@ -1,6 +1,8 @@
-调用 `verification-before-completion`。未运行验证命令，不得声明完成。
+这是 `command:start` 之后的 **完成前验证阶段入口**。
 
-## 核心动作
+当 `command:quality-review` 已经收敛，或者你准备声明“任务已完成、问题已修复、产物可交付”时，就从这里接力到 `verification-before-completion`。
+
+## 当前阶段要做什么
 
 1. 明确验证目标：你准备声明什么已经成立
 2. 执行新鲜验证：测试、构建、检查或运行验证
@@ -8,25 +10,18 @@
 4. 带证据汇报：通过则给证据，不通过则报失败点
 5. 必要时对照 Spec / Plan 做逐项核验
 
-## 相关原则
+## 当前阶段的边界
 
 - 证据先于断言
 - 不依赖历史输出和主观感觉
-- 失败时先说明实际结果，再判断下一步
-
-## 使用方式
+- 验证失败时先说明实际结果，再决定是否回退
 
-在完成任何实现工作后使用。描述要验证的内容，我会执行完整验证流程。
+## 从这里通常接到哪里
 
-### 示例
+- 验证通过：可以进入提交、交付或下一轮任务
+- 验证失败：回到 `command:build`
+- 如果失败暴露范围理解错误：回到 `command:spec` 或 `command:task-plan`
 
-```
-# 功能实现后验证
-/verify 确认用户登录功能的所有测试通过，构建成功
-
-# Bug 修复后验证
-/verify 确认批量导入的重复数据问题已修复，回归测试全部通过
+## 使用方式
 
-# Spec 对照验证
-/verify 对照 spec.md 逐项检查文件上传功能的实现完整性
-```
+说明要验证的结论或交付声明，我会执行完整验证流程，并明确是否真的可以宣布完成。

package/vendor/packages/toolkit/src/content/commands/verify/meta.yaml

@@ -12,7 +12,21 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
+workflow_family: lifecycle
+workflow_role: stage-entry
+task_types:
+  - feature
+  - bugfix
+  - review
+  - docs
+  - release
+platform_exposure:
+  codex: prompt-entry
+  qwen: command-style
+  claude: command-style
+  opencode: command-style
 source:
   upstream: andrej-karpathy-skills
   strategy: inspired

package/vendor/packages/toolkit/src/content/skills/api-and-interface-design/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/brainstorming-and-design/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: superpowers
   strategy: inspired

package/vendor/packages/toolkit/src/content/skills/branch-finish-and-cleanup/meta.yaml

@@ -10,7 +10,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: superpowers
   strategy: inspired

package/vendor/packages/toolkit/src/content/skills/browser-qa-testing/meta.yaml

@@ -10,7 +10,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/ci-cd-and-automation/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/code-review-and-quality/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/code-simplification/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/codebase-onboarding/body.md

@@ -1,5 +1,7 @@
 # 代码库导览
 
+这是 `command:start` 判型后进入的专项 skill：当任务核心是理解陌生项目、建立上下文地图、决定下一步从哪里切入时，进入这里。
+
 ## 何时使用
 
 - 第一次接触一个代码库
@@ -34,7 +36,8 @@
 - 聚焦当前任务相关区域，不求一次理解全仓库
 - 概览是压缩上下文，不是转述源码
 
-## 与其他技能的衔接
+## 回到主流程
 
-- 产出的概览可直接供 `context-engineering` 使用
-- 在陌生项目上做需求或实现前，可先接 `brainstorming-and-design` / `spec-driven-development`
+- 项目地图已经足够，可交给 `context-engineering` 做最小上下文装载
+- 如果接下来要定义需求或方案：回到 `spec-driven-development`
+- 如果已经确认目标，只是缺实现上下文：回到 `incremental-implementation`

package/vendor/packages/toolkit/src/content/skills/codebase-onboarding/meta.yaml

@@ -10,7 +10,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/context-budget-audit/meta.yaml

@@ -10,7 +10,8 @@ requires:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: toolkit-original
   strategy: curated

package/vendor/packages/toolkit/src/content/skills/context-engineering/body.md

@@ -1,5 +1,7 @@
 # 上下文工程
 
+这是 `command:start` 判型后进入的专项 skill：当任务核心不是“做什么”，而是“如何把正确上下文装载给接下来的阶段”，进入这里。
+
 ## 何时使用
 
 - 开始新的编码会话或新子任务时
@@ -47,9 +49,9 @@
 - 规格和规则优先于猜测
 - 压缩上下文是持续动作，不是最后补救
 
-## 与其他技能的衔接
+## 回到主流程
 
-- 与 `engineering-principles` 配合，在进入实现前先校准工作方式
-- 与 `codebase-onboarding` 配合，先建立地图再装载局部上下文
-- 与 `context-budget-audit` 配合，检查上下文是否膨胀
-- 为几乎所有实现和审查技能提供前置支持
+- 上下文已校准完成：回到后续真正要执行的阶段或专项入口
+- 需求仍模糊：回到 `spec-driven-development`
+- 任务已经明确、准备实现：回到 `incremental-implementation`
+- 会话健康恶化明显：结合 `context-budget-audit`

package/vendor/packages/toolkit/src/content/skills/context-engineering/meta.yaml

@@ -10,7 +10,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: superpowers
   strategy: inspired

package/vendor/packages/toolkit/src/content/skills/continuous-learning/body.md

@@ -162,7 +162,7 @@ Hooks 是确定性的 — 只要事件触发，脚本就一定执行，不受模
 ### 文件结构
 
 ```
-~/.qoder/homunculus/
+~/.zc/homunculus/
 ├── observations.jsonl          # 全局观察（无项目时的 fallback）
 ├── instincts/
 │   ├── personal/               # 全局自动学习的 instincts
@@ -197,8 +197,8 @@ Hooks 是确定性的 — 只要事件触发，脚本就一定执行，不受模
 # 自动检测平台并安装
 bash skills/continuous-learning/hooks/setup.sh
 
-# 指定平台
-bash skills/continuous-learning/hooks/setup.sh --platform qoder
+# 指定平台适配器（按脚本支持情况选择）
+bash skills/continuous-learning/hooks/setup.sh --platform codex
 bash skills/continuous-learning/hooks/setup.sh --platform qwen-code
 ```
 
@@ -207,8 +207,8 @@ bash skills/continuous-learning/hooks/setup.sh --platform qwen-code
 # 自动检测平台并安装
 .\skills\continuous-learning\hooks\setup.ps1
 
-# 指定平台
-.\skills\continuous-learning\hooks\setup.ps1 -Platform qoder
+# 指定平台适配器（按脚本支持情况选择）
+.\skills\continuous-learning\hooks\setup.ps1 -Platform codex
 .\skills\continuous-learning\hooks\setup.ps1 -Platform qwen-code
 
 # 卸载
@@ -217,16 +217,16 @@ bash skills/continuous-learning/hooks/setup.sh --platform qwen-code
 
 ### 手动配置
 
-在 `~/.qoder/settings.json`（Qoder）或对应配置文件中添加：
+在你所使用平台支持的 hooks / automation 配置文件中接入观察脚本。下面只给出一个通用示意，实际键名和事件名应以目标平台官方文档为准：
 
 **macOS / Linux:**
 ```json
 {
   "hooks": {
-    "PostToolUse": [{"matcher": "*", "hooks": [{"type": "command", "command": "~/.qoder/hooks/continuous-learning/observe.sh"}]}],
-    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "~/.qoder/hooks/continuous-learning/observe.sh"}]}],
-    "PostToolUseFailure": [{"matcher": "*", "hooks": [{"type": "command", "command": "~/.qoder/hooks/continuous-learning/observe.sh"}]}],
-    "Stop": [{"hooks": [{"type": "command", "command": "~/.qoder/hooks/continuous-learning/session-end.sh"}]}]
+    "PostToolUse": [{"matcher": "*", "hooks": [{"type": "command", "command": "~/.zc/hooks/continuous-learning/observe.sh"}]}],
+    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "~/.zc/hooks/continuous-learning/observe.sh"}]}],
+    "PostToolUseFailure": [{"matcher": "*", "hooks": [{"type": "command", "command": "~/.zc/hooks/continuous-learning/observe.sh"}]}],
+    "Stop": [{"hooks": [{"type": "command", "command": "~/.zc/hooks/continuous-learning/session-end.sh"}]}]
   }
 }
 ```
@@ -235,10 +235,10 @@ bash skills/continuous-learning/hooks/setup.sh --platform qwen-code
 ```json
 {
   "hooks": {
-    "PostToolUse": [{"matcher": "*", "hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.qoder/hooks/continuous-learning/observe.ps1\""}]}],
-    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.qoder/hooks/continuous-learning/observe.ps1\""}]}],
-    "PostToolUseFailure": [{"matcher": "*", "hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.qoder/hooks/continuous-learning/observe.ps1\""}]}],
-    "Stop": [{"hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.qoder/hooks/continuous-learning/session-end.ps1\""}]}]
+    "PostToolUse": [{"matcher": "*", "hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.zc/hooks/continuous-learning/observe.ps1\""}]}],
+    "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.zc/hooks/continuous-learning/observe.ps1\""}]}],
+    "PostToolUseFailure": [{"matcher": "*", "hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.zc/hooks/continuous-learning/observe.ps1\""}]}],
+    "Stop": [{"hooks": [{"type": "command", "command": "pwsh -NoProfile -File \"~/.zc/hooks/continuous-learning/session-end.ps1\""}]}]
   }
 }
 ```
@@ -360,7 +360,7 @@ Memory 存储格式：
 设置完成后确认：
 
 - [ ] Hook 脚本已安装且有执行权限
-- [ ] `~/.qoder/homunculus/` 目录结构已创建
+- [ ] `~/.zc/homunculus/` 目录结构已创建
 - [ ] PostToolUse hook 能正常记录观察（检查 observations.jsonl）
 - [ ] `/learn` 命令能正确分析并提取 instincts
 - [ ] 高置信度 instincts 已同步到 Agent Memory

package/vendor/packages/toolkit/src/content/skills/continuous-learning/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: toolkit-original
   strategy: curated

package/vendor/packages/toolkit/src/content/skills/debugging-and-error-recovery/body.md

@@ -1,17 +1,19 @@
 # 调试与恢复
 
+这是 `command:start` 判型后进入的专项 skill：当任务核心是定位问题、复现异常、确认根因时，进入这里，而不是继续沿完整交付流程硬推。
+
 ## 何时使用
 
 - 测试失败、构建报错或运行结果与预期不一致
 - 收到 bug 报告，需要先复现再修复
-- 某个问题开始反复出现，但根因不清楚
+- 某个问题反复出现，但根因不清楚
 - 你已经开始“凭感觉试错”时
 
 ## 输入前提
 
 - 已保留失败证据：报错、日志、复现步骤或测试输出
-- 愿意暂停继续开发，先处理当前异常
-- 接受先定位根因，再动实现
+- 接受先停线，再定位，不继续叠加功能
+- 愿意先把异常收敛成可验证问题，再回到实现主线
 
 ## 执行步骤
 
@@ -36,8 +38,9 @@
 - 先复现，再修复
 - 调试过程必须保留证据链
 
-## 与其他技能的衔接
+## 回到主流程
 
-- bug 修复时与 `test-driven-development` 的 Prove-It 模式配合
-- 修复完成后交给 `verification-before-completion`
+- 根因已明确、开始正式实现修复：回到 `incremental-implementation`
+- 修复完成，需要确认是否真的恢复：交给 `verification-before-completion`
+- 如果问题暴露了需求或方案错误：回到 `spec-driven-development` 或 `planning-and-task-breakdown`
 - 当问题涉及架构性缺陷时，可转给 `architect`

package/vendor/packages/toolkit/src/content/skills/debugging-and-error-recovery/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/deprecation-and-migration/meta.yaml

@@ -11,7 +11,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: agent-skills
   strategy: adapted

package/vendor/packages/toolkit/src/content/skills/developer-experience-audit/meta.yaml

@@ -10,7 +10,8 @@ suggests:
 platforms:
   - qwen
   - codex
-  - qoder
+  - claude
+  - opencode
 source:
   upstream: gstack
   strategy: inspired