Easyuseaide project bootstrap

项目上下文初始化

为预计跨多个会话、包含多个模块、需要持续维护或可能由多个 Agent 接力的项目建立最小项目上下文。

本 Skill 是 EasyUseAIDE 项目上下文目录结构、文件职责、初始化条件、更新规则和归档交接规则的权威来源，但不替代已经生效的需求澄清、设计或实施框架。

1. 适用边界

适用于：

• 新建正式工程；
• 项目预计跨多个会话或持续一周以上；
• 涉及多个模块、外部接口、持久化数据或部署；
• 用户明确要求建设可维护、可交接的项目；
• 现有上下文文件缺失、重复或相互冲突。

满足“新建正式工程”，并同时涉及多模块、持久化数据、部署、共享、长期维护或计划开源中的任一项时，应在首次实现前使用本 Skill。用户在聊天中提供了完整需求，只能作为项目文档的输入，不能替代仓库内可跨会话读取的上下文。

一次性脚本、临时实验、简单页面和低风险小工具不机械创建全套文件。

只读分析、解释、代码审查和用户未授权写入的诊断任务，不创建或更新项目上下文文件。此时可以报告缺失项或提出结构建议，但不得把建议直接写入项目。

已有框架已经生成设计或实施计划时，保留其原有文件和职责，在项目状态或任务卡中引用，不复制全文，也不为 EasyUseAIDE 另建同义文件。只有现有体系缺失、重复、失效或用户明确要求修复时才初始化。

2. 执行步骤

1. 检查现有项目规则、README、docs、ADR、任务卡和 contracts。
2. 优先沿用现有体系，不创建重复事实源。
3. 判断项目规模并选择最小必要文件：
   • 小型项目：项目规则文件、README、docs/project-status.md；
   • 中长期项目：增加 PRD 和 architecture；
   • 中高风险或跨模块任务：按需增加 docs/tasks/；
   • 存在重要长期决策或机器契约时：增加 ADR 和 contracts。
4. 读取本 Skill 对应的模板资产，根据项目真实信息填写。
5. 在 PRD 中明确主要使用渠道、第一用户旅程、次要界面和质量优先级；先验证最能决定项目成败的真实链路。
6. 已确认事实写入文件；不确定内容标记为待确认，不自行补成事实。
7. 不覆盖已有有效内容；发现冲突时先列出差异。
8. 生成 README 时删除项目中不存在的文档链接，不得生成死链。
9. 初始化完成后说明每个文件的职责和后续更新时机。
10. 项目准备长期维护、共享、发布、部署或保存持久化数据时，在首次里程碑宣布完成前继续使用 easyuseaide-project-delivery-readiness Skill；本 Skill 不重复维护交付流程。
11. 新生成或更新项目专属规则后，按当前 IDE 的官方刷新方式重载规则或新开会话，并验证项目专属规则已实际进入上下文；当前会话创建了文件不代表它已经生效。

3. 推荐结构

项目根目录/
├── AGENTS.md
├── README.md
├── docs/
│   ├── product/
│   │   └── PRD.md
│   ├── architecture.md
│   ├── project-status.md
│   ├── tasks/             # 中长期项目按需创建
│   ├── adr/
│   ├── operations.md      # 需要最低交付能力时按需创建
│   └── runbooks/          # 有备份、发布或恢复流程时按需创建
└── contracts/

需要兼容其他项目规则文件名时，优先使用该工具支持的导入机制；无法导入时创建内容一致的兼容副本，并明确 AGENTS.md 为内容权威来源。

4. 文件职责

• AGENTS.md：在通用规则之外补充本项目长期稳定的技术栈、目录职责、常用命令、修改边界和完成门禁；不能只保留通用 EasyUseAIDE 规则；
• README.md：项目入口、安装、启动、测试和实际存在的文档链接；
• docs/product/PRD.md：目标、主要使用渠道、第一用户旅程、范围、质量优先级、业务规则、权限范围和验收标准；
• docs/architecture.md：系统边界、组件、数据流、契约来源和质量属性；
• docs/project-status.md：当前阶段、完成结论、验证证据、阻塞、风险和下一步入口；
• docs/tasks/：中高风险或跨模块任务的任务卡及验收依据；
• docs/adr/：重要且长期有效的技术决策；
• docs/operations.md：启动、配置、CI、数据、日志和发布的运行入口，按需创建；
• docs/runbooks/：需要逐步执行和验证的备份、恢复、发布或回滚流程，按需创建；
• contracts/：OpenAPI、Schema、AsyncAPI、Protobuf 等机器可验证契约。

5. 更新规则

• 需求和范围变化：更新 PRD；
• 架构、接口和数据流变化：更新 architecture 或 ADR；
• 当前进度、验证、阻塞和下一步变化：更新 project-status；
• 长期稳定的项目约定变化：更新项目级规则文件；
• 接口和数据模型变化：同步更新 contracts、迁移和测试；
• 中高风险或跨多个模块的任务：实施前创建任务卡；
• 任务完成后保留任务卡，作为规格和验收证据；
• project-status.md 只记录任务卡链接与验证结论，不复制完整任务卡；
• 已完成任务卡按里程碑或版本归档；
• 会话结束、任务中断或切换 Agent 前，只有在任务实际改变项目状态且写入已获授权时才更新 project-status；
• 接力前记录 Git 状态和当前提交、尚未提交的改动、下一条可执行命令及需要重复的验证；没有首个提交或仍有未说明改动时不得标记为安全接力；
• 未经用户授权不自动提交，只如实记录当前是否已形成 Git 检查点。

同一事实只能有一个权威来源，其他文件只引用或记录摘要。

6. 模板资产

按需读取：

• assets/templates/AGENTS.md
• assets/templates/README.md
• assets/templates/docs/product/PRD.md
• assets/templates/docs/architecture.md
• assets/templates/docs/project-status.md
• assets/templates/docs/tasks/task-card.md
• assets/templates/docs/adr/ADR-template.md
• assets/templates/contracts/README.md

不得机械生成全部模板；只创建当前项目实际需要的文件。