Menü
用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
规范驱动开发工具包。绿地用 /sillyspec:init，棕地用 /sillyspec:scan，全自动用 /sillyspec:auto。完整流程：scan → brainstorm → plan → execute → verify → archive。支持 TDD、子代理并行、worktree 隔离、E2E 验证。兼容 Claude Code / Cursor / Codex / OpenCode / OpenClaw。
用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
用于把 design 拆解为可执行的实现计划。适合用户说"拆任务、做计划、排 wave、规划实现步骤"。产出 plan.md（Wave 分组 + Task 列表 + 依赖关系）。
生成结构化规范 — proposal + design + tasks。适合用户说"生成规范、补全四件套、propose"。产出 proposal.md + design.md + tasks.md（+ 可能的 requirements.md）。
用于明确、低风险、范围很小的直接任务。适合用户说"直接改、快速修、顺手调整、改个文案、修个小 bug、更新一个文件、不要完整流程"。跳过 brainstorm/plan，但仍按 sillyspec quick 流程执行。
用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
| name | sillyspec:scan |
| description | 用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。 |
scan 是辅助阶段，通常不需要 --change。但项目有多个活跃变更时，所有 sillyspec run 命令加 --change <变更名> 可指定操作目标。
sillyspec scan是sillyspec run scan的顶层别名，两者等价。
sillyspec run scan # 输出当前步骤 prompt
sillyspec run scan --done --output "摘要" # 完成当前步骤
sillyspec run scan --status # 查看阶段进度
sillyspec run scan --skip # 跳过可选步骤
sillyspec run scan --reset # 重置阶段（从头开始）
| 参数 | 说明 |
|---|---|
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--skip-approval | 跳过审批/校验门控 |
--json | 输出 JSON（程序化读取） |
| 参数 | 说明 |
|---|---|
--deep | 强制 deep 扫描 profile（完整流程，不按规模裁剪） |
--force-rescan | 覆盖已有 scan 文档的保护（默认覆盖需 source_commit/updated_at 匹配） |
CLI 根据源码规模自动选择 profile，无需手动指定：
| profile | 触发条件 | 行为 |
|---|---|---|
| quick | ≤30 文件 且 ≤80KB 且 ≤3 项目 | 3 步，0 子代理，5 份核心文档 |
| standard | ≤200 文件 且 ≤800KB | 压缩步骤，最多 1 子代理 |
| deep | 大项目或 --deep | 完整流程 |
scan 完成时 CLI 自动校验 7 份文档齐全。缺失会设状态为 failed_post_check，阻断进入主流程下游（brainstorm/plan 等），需修复后重跑 scan。
(项目起点) → scan → brainstorm
scan 完成后，运行 sillyspec run brainstorm "<需求>" 开始具体变更的设计。
{DOCS_ROOT}/scan/（平台模式用占位符路径，不写裸 .sillyspec/）--done，不跳过$ARGUMENTS