timzaak/web-dev-skills/t-how

教用户使用 t-tools

交互式使用向导：弄清用户想做什么，讲解对应工作流，并给出应执行的入口命令。只讲解和指路，不执行任何 t-* 工作流，不读写目标项目文件，也不代替用户做检查或初始化。

参数

/t-how [主题或问题]

主题可省略。省略时先展示主链路和常见场景，用 AskUserQuestion 让用户选择（选项来自场景路由表），或自由描述目标。

输出语言跟随用户输入。

主链路

t-decision -> t-prd / t-tech-research（无固定顺序，进设计前收敛）
-> t-design -> t-super-run
-> t-web-demo-* / t-extension-demo-* / t-flutter-demo-* -> t-prd-publish -> t-push -> t-release

t-prd-check、t-design-check、t-task-check 是可选质量检查。phase 顺序：Web 为 backend -> frontend -> web-demo，扩展项目为 extension -> extension-demo（需要后端改动时前置 backend），Flutter 为 backend -> flutter -> flutter-demo，Shopify 为 shopify-app -> shopify-extension -> web-demo（仅在设计要求店面、admin 或顾客账户用户故事演示时启用 web-demo）。

场景路由

按用户目标匹配下表，讲解时给出命令、关键前置条件和下一步。匹配多个场景时全部列出，让用户确认顺序。

讲解 --phase <phase> 可选值或启用条件时，读取 ${CLAUDE_PLUGIN_ROOT}/protocols/task-phase-execution.md 的 Phases；只展示与用户场景相关的阶段，参数说明不展开完整枚举。

表外还有 t-html-show 等辅助命令：用 Glob 列出 ${CLAUDE_PLUGIN_ROOT}/skills/，读对应 SKILL.md 开头确认职责后再讲解。

讲解方式

• 先给最短可用路径（1-3 条命令），再按需展开阶段细节；不要一次性铺开全部工作流。
• 涉及前置条件时（docs/、.ai/ 目录，context7 MCP，Figma MCP，--device 等），随命令一起说明，但不要代替用户检查或创建。
• 用户想理解整体设计思路（skill、subagent、protocol 如何协同）时，读取 ${CLAUDE_PLUGIN_ROOT}/human/structure.md 再讲解。
• 用户要完整命令示例时，指向仓库 README 的“快速上手”章节。
• 用户在 Codex / ZCode 等不支持 claude --plugin-dir 的工具里时，说明命令形式对应 /t-tool <skill-name>，见 ${CLAUDE_PLUGIN_ROOT}/human/use-in-other-agents.md。

失败处理

• 匹配不到场景：列出场景路由表的目标列让用户选择，或请用户换个说法描述目标。
• 用户问的命令不存在：用 Glob 列出实际可用的 skill，纠正命令名。
• 用户要求直接开工：说明本 skill 只负责讲解，给出应执行的命令，由用户显式触发。