| name | project-kickoff-delivery-zh |
| description | 项目启动交付技能:用于外包、比赛、课程和工程项目从读题、调研、需求拆解、技术选型、团队分工、接口/数据库设计、启动命令到启动记忆入口的交付流程。Use when: 项目启动、外包项目、比赛项目、团队分工、技术选型、需求拆解、接口文档、数据库设计、项目计划、启动命令、启动记忆、AGENTS读取顺序、前后端联调、交付验收。 |
项目启动交付技能
Project structure gate / 文件树结构门禁
只要本工作流将初始化或重组项目,或新建、移动应用、服务、包、模块、页面、API、研究步骤、实验、流水线、测试、文档或多文件产物树,必须先使用 project-structure-architect。
- 开始前:读取适用的
AGENTS.md、PROJECT_STRUCTURE.md、.project-structure.yaml 和现有文件树,锁定项目类型、蓝图及唯一合理路径。
- 运行中:每次新增或移动文件前先判断职责、所有者、复用范围和对应测试;禁止同义目录、根目录堆放、跨层混放及无关重组。
- 阶段收口:纵向切片或阶段完成后检查结构漂移;新项目或重大重组更新结构文档,最终运行结构审计。出现
BLOCK 时停止结构性写入并先修正或询问用户。
纯内容编辑且目标路径已由用户或现有规范唯一确定时,可不重复调用。
目标
把项目从“想做什么”推进到“团队知道怎么分工、代码知道怎么启动、交付知道怎么验收、下一位 AI 知道先读哪里和继承什么”。
启动流程
- 读题和定位:明确要解决什么问题、用户是谁、最终交付物是什么。
- 信息调研:找现成方案、竞品、论文/开源代码和可复用组件。
- 痛点和应用方案:从实际需求出发写用户侧方案,而不是先堆技术。
- 技术选型:前端、后端、数据库、模型服务、部署方式。
- 接口和数据设计:先定接口文档、核心表、字段、状态流。
- 团队分工:把任务按模块切给人,明确输入、输出和验收。
- 启动链路:写清前端、后端、模型服务、数据库的启动命令。
- 交付验收:功能闭环、演示路径、截图清单、风险清单。
- 启动记忆闭环:建立或更新
AGENTS.md / CLAUDE.md 的启动读取顺序,生成单文件启动记忆;长期迭代项目再拆入三层记忆入口。
输出要求
- 项目一句话定位
- 目标用户和痛点
- 技术栈与理由
- 模块分工表
- 接口/数据库初稿
- 启动命令
- 里程碑和验收标准
- 根规则入口:
AGENTS.md / CLAUDE.md 的启动读取顺序、边界和禁止事项
- 单文件启动记忆:至少包含
尝试方法、计划、脚本/命令、结果、经验
- 长期项目的三层记忆入口:第二层总览或单文件记忆桥,以及第三层
计划/、尝试方法/、脚本/、结果/、经验/
约束
- 先闭环,再扩展。
- 先真实可跑,再美化。
- 先定接口,再分头开发。
- 不要让团队成员同时改同一层的同一文件。
- 不要把模型服务、后端、前端的启动命令混在一起。
- 不要只交付启动命令而不落启动记忆。
- 不要把
AGENTS.md 写成流水日志;它只保存读取顺序、硬边界和跳转入口。
- 单文件启动记忆可以作为第二层记忆桥,但长期项目必须把完整证据沉到第三层。
资源
- 项目启动规则:
references/project-startup-rules.md
- 启动命令模板:
assets/startup-command-template.md
- 三层记忆入口模板:
../project-handoff-zh/assets/三层记忆入口模板.md