Menu
用于扫描项目代码库，生成架构文档、代码约定、目录结构等。适合用户说"扫描项目、分析代码库、生成文档、scan"。产出 7 份扫描文档 + 模块映射。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
规范驱动开发工具包。绿地用 /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