project-bootstrapper

项目初始化工具

通过开发最佳实践、工具、文档和工作流自动化，搭建新项目或改进现有项目。

适用场景

• “搭建新项目”
• “初始化这个项目”
• “添加最佳实践”
• “改进项目结构”
• “配置开发工具”
• “正确初始化项目”

设置内容

1. 项目结构

• 标准目录（src/、tests/、docs/、scripts/、.github/）
• 合理的文件组织
• 结构改进

2. Git 配置

• 完整的 .gitignore
• 用于处理换行符和差异的 .gitattributes
• Git 钩子（pre-commit、commit-msg）
• 分支保护模式
• 按需配置 Git LFS

3. 文档

• 完整的 README.md
• CONTRIBUTING.md
• 代码文档（JSDoc、文档字符串）
• CHANGELOG.md 结构
• 复杂项目的架构文档

4. 测试配置

• 确定／推荐测试框架
• 测试结构和约定
• 示例／模板测试
• 配置测试运行器
• 覆盖率报告
• 测试脚本／命令

5. 代码质量工具

• 代码检查工具（ESLint、Pylint 等）
• 格式化工具（Prettier、Black 等）
• 类型检查（TypeScript、mypy 等）
• 用于保障质量的 pre-commit 钩子
• 编辑器配置（.editorconfig）
• 代码质量徽章

6. 依赖项管理

• 包管理器配置
• 整理依赖项
• 检查安全漏洞
• 配置依赖项更新（Dependabot、Renovate）
• 创建锁定文件
• 说明依赖项选择依据

7. 开发工作流

• 实用的 npm 脚本／Makefile 目标
• 环境变量模板（.env.example）
• 适用时配置 Docker
• 开发启动脚本
• 热重载／监视模式
• 编写开发工作流文档

8. CI/CD 配置

• GitHub Actions／GitLab CI 配置
• 自动化测试
• 自动化部署（如适用）
• 状态徽章
• 发布自动化
• 分支保护

工作方式

发现阶段

提出澄清问题：

1. 项目类型：新项目还是现有项目？
2. 主要用途：Web 应用、库还是命令行工具？
3. 语言／框架：JS/TS、Python、Go 等？
4. 协作方式：个人开发还是团队协作？
5. 部署目标：服务器、云端、移动端还是桌面端？
6. 偏好：是否有指定的工具／框架？
7. 范围：完整配置还是只配置特定部分？

实施阶段

1. 分析现有结构（如果是现有项目）
2. 根据回答制定计划
3. 展示计划并征求批准
4. 系统地实施（每次处理一个方面）
5. 验证完整性
6. 提供交接文档

定制化

适配以下情况：

• 语言生态：Node.js、Python、Go 或 Rust
• 项目规模：小型脚本或大型应用
• 团队规模：个人开发或团队协作
• 成熟度：初创项目的快速迭代或企业级标准

使用的工具

• AskUserQuestion：收集需求
• Write：创建配置文件和文档
• Edit：更新现有文件
• Bash：初始化工具（git init、npm init）
• Read：分析现有结构
• Glob：查找要更新的文件

成功标准

• 所有标准文件均已创建并配置
• 文档清晰、完整
• 开发工作流有文档说明
• 配置了自动化质量工具（pre-commit 钩子）
• 测试易于运行
• 遵循语言／框架约定
• 新开发者能够快速上手
• 没有明显遗漏的最佳实践

模板

• Node.js/TypeScript Web 应用
• Python 命令行工具
• Python Web API（FastAPI/Flask）
• React/Next.js 应用
• Go 服务
• Rust 命令行工具／库

集成

• feature-planning：规划自定义功能
• code-auditor：验证配置质量
• codebase-documenter：生成详细文档

范围控制

• 完整初始化：从零开始完成所有配置
• 部分配置：仅配置特定方面（例如“只添加测试”）
• 改进检查：增强现有项目
• 审查并修复：检查缺失项并补齐