القائمة
用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
本地打包镜像→远程服务器（阿里云）部署，替代服务器现场构建。适合用户说"部署到服务器"、"远程部署"、"更新生产环境"、"首次部署到阿里云"、"打包传镜像"、"不在服务器构建"。区分首次部署（服务器从零）和更新部署（已有环境换镜像）。
用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
用于按 plan 执行代码实现。适合用户说"开始写代码、执行任务、跑 execute、开干"。按 plan.md 中的 Wave 和 Task 逐步实现，遵循 design.md 和模块文档。
用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
| name | sillyspec:brainstorm |
| description | 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。 |
当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。 不要用编号列表让用户手动输入数字。
design.md + proposal.md + requirements.md + tasks.md（四件套），不写代码项目有多个活跃变更（.sillyspec/changes/ 下有多个目录）时，所有 sillyspec run 命令需加 --change <变更名> 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：YYYY-MM-DD-<简短描述>。
sillyspec brainstorm是sillyspec run brainstorm的顶层别名，两者等价。
sillyspec run brainstorm # 输出当前步骤 prompt
sillyspec run brainstorm --done --output "摘要" # 完成当前步骤（--input "用户原话" 记录输入）
sillyspec run brainstorm --status # 查看阶段进度
sillyspec run brainstorm --skip # 跳过可选步骤
sillyspec run brainstorm --reset # 重置阶段（从头开始）
sillyspec run brainstorm --reopen --from-step N # 重新打开已完成阶段修订（N=序号或名称）
sillyspec run brainstorm --wait --reason "..." --options "A,B" # 暂停等用户决策
sillyspec run brainstorm --continue --answer "..." # 恢复等待中的步骤
sillyspec run brainstorm --done --answer "..." --output "..." # 一步完成 wait+done
| 参数 | 说明 |
|---|---|
--change <名> | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过审批/校验门控（需明确意图） |
--json | 输出 JSON（程序化读取） |
某些步骤（如"对话式探索"）需要用户输入。两种方式：
sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
--wait 记录等待，再 --continue --answer，最后 --done：
sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
sillyspec run brainstorm --continue --answer "用户回答" --change <名>
sillyspec run brainstorm --done --change <名> --output "需求已澄清"
scan → brainstorm → plan
brainstorm 完成后（四件套齐 + 自审通过），运行 sillyspec run plan --change <变更名> 进入实现计划。
changeDir 目录（如 <changeDir>/design.md），不要自己拼路径--done，不跳过$ARGUMENTS