--- name: 0001-bootstrap-workflow description: 初始化项目协作基线，创建项目蓝图和协作协议文档 --- # 技能：项目协作基线初始化 (Bootstrap Workflow) ## 元数据 (Metadata) - **name**: bootstrap-workflow - **description**: 初始化项目协作基线，创建项目蓝图和协作协议文档 - **version**: 1.0.0 - **author**: SSOT Architect - **lastUpdated**: 2026-01-15 ## 触发与定位 (Triggers & Scope) ### 触发条件 (Triggers) 当以下情况发生时，AI 应当"觉醒"本技能： 1. **新项目初始化**: 用户要求初始化一个新的 Datai 项目 2. **缺少协作文档**: 检测到项目根目录缺少 `README.md`、`CONTRIBUTING.md` 或 `CHANGELOG.md` 3. **工作流启动**: 用户输入 "Start Workflow: [任务名称]" 指令 4. **文档结构检查**: 在执行任何开发任务前，发现项目文档结构不完整 ### 定位范围 (Scope) - **适用模块**: 所有 Datai 项目模块 - **影响文件**: 项目根目录的协作文档 - **相关技能**: skill-establish-ssot-hub, skill-setup-information-architecture ## 核心指令集 (Instructions) ### 架构约束 (Architecture Constraints) 1. **必须创建的文件**: - `README.md` - 项目蓝图，必须包含指向 `docs/index.md` 的显著链接 - `CONTRIBUTING.md` - AI 与人类协作协议 - `CHANGELOG.md` - 项目变更日志 2. **README.md 必须包含**: - 项目简介 - 技术栈 - 快速开始指南 - **显著链接**: 指向 `docs/index.md` 的链接 - 贡献指南链接 3. **CONTRIBUTING.md 必须包含**: - 项目协作流程 - 提交规范 - 代码审查流程 - 文档更新要求 4. **CHANGELOG.md 必须包含**: - 版本历史 - 变更类型说明（feat, fix, docs, refactor, etc.） - 变更日期 ### 业务逻辑 SOP (Business Logic SOP) #### 步骤 1: 检查现有文档 ```bash # 检查项目根目录是否存在必需文件 if [ ! -f "README.md" ]; then echo "警告: README.md 不存在" fi if [ ! -f "CONTRIBUTING.md" ]; then echo "警告: CONTRIBUTING.md 不存在" fi if [ ! -f "CHANGELOG.md" ]; then echo "警告: CHANGELOG.md 不存在" fi ``` #### 步骤 2: 创建 README.md ```markdown # [项目名称] > 项目唯一真源入口：[docs/index.md](docs/index.md) ## 项目简介 [项目描述] ## 技术栈 - Java 17/21 - Spring Boot 3.x - MyBatis Plus - Salesforce API ## 快速开始 [快速开始步骤] ## 文档导航 - [完整文档](docs/index.md) - [贡献指南](CONTRIBUTING.md) - [变更日志](CHANGELOG.md) ## 许可证 [许可证信息] ``` #### 步骤 3: 创建 CONTRIBUTING.md ```markdown # 贡献指南 ## 协作流程本项目遵循严格的 SSOT（Single Source of Truth）架构，所有开发必须遵循文档驱动的流程。 ## 提交规范 ### Commit Message 格式 ``` ():