核心用法
solo-scaffold 是面向 AI 驱动的项目初始化工具，用户通过 /scaffold [project-name] [stack-name] 即可从 PRD 文档和栈模板生成完整可运行的项目。Skill 自动完成：参数解析与缺失补全、组织默认值配置、栈模板加载、现有项目模式研究（SoloGraph）、最新依赖版本查询（Context7）、项目计划确认、目录与文件生成、Git 初始化与 GitHub 推送。
显著优点
1. 智能化模式继承：通过 SoloGraph MCP 主动研究用户现有同栈项目，批判性评估后采纳最佳实践，避免盲目复制遗留代码
2. 版本实时同步：Context7 MCP 查询关键包的最新版本和推荐配置，确保新项目不依赖过时依赖
3. AI 友好设计：每个项目生成专属 .claude/skills/dev/SKILL.md，使 Claude 能立即理解项目结构和工作流
4. 工程规范内置：强制包含 CLI-First Testing、Harness Engineering、SGR（Schema-First）等原则
5. 完整 DevOps 链路：Makefile 标准化命令、CLAUDE.md 项目地图、自动 GitHub 仓库创建
潜在缺点与局限性
- MCP 依赖：SoloGraph 和 Context7 的功能需要对应 MCP 服务器运行，否则回退到内置知识和栈模板版本
- 栈模板覆盖：8 种预定义栈结构（Next.js、iOS Swift、Kotlin、Cloudflare、Astro 等），小众技术栈需手动扩展
- 研究深度权衡：限制 2-3 个 sibling 项目和 3-4 个关键包的研究，复杂企业级项目可能需要额外调研
- 首次配置成本：需要预先配置
~/.solo-factory/defaults.yaml和gh auth login
适合人群
- 需要频繁启动新项目的独立开发者或技术负责人
- 追求代码库一致性的团队（通过 SoloGraph 学习现有模式）
- 希望新项目自动符合最新最佳实践的技术洁癖用户
- 使用 Claude 作为主力开发助手的 AI-Native 开发者
常规风险
- 文件系统操作：在用户确认后创建目录和文件，需确认目标路径正确
- GitHub 仓库创建：依赖
ghCLI 认证状态，失败时需手动重试 - 网络查询依赖：Context7 和 SoloGraph 的 MCP 调用可能受限于服务可用性
安全认证
CLS-Certify v2.1.0 评级 S 级（95分），无危险函数使用，权限控制得当，网络操作透明，符合 GDPR 数据最小化原则。