功能开发
- 先判断目录里是否已有可继续开发的项目。空目录、只有无关文件或尚无可运行项目骨架时,这是新项目设置,不是普通功能开发;先使用
project-setup澄清项目形态并确认关键选型,完成后再回到本流程。若未安装project-setup,直接完成同样的最少澄清与确认;在关键分歧未解决前不新建应用文件。已有项目则明确本次需求与完成条件,读取相关规则、已确认的架构决策、当前状态和涉及的代码;交接信息须与实际文件核对。 - 搜索相近实现、公共函数、组件、依赖和测试。复用职责相同且不会明显增加耦合的实现;否则说明为何新增代码更合适。
- 对较大改动简要规划后实施。技术栈、模块边界或数据模型的重大变化先说明取舍并取得开发者确认,再按
project-setup记录新的 ADR。普通实现不需要重复请求确认。 - 运行与改动相关的项目检查。区分通过、失败、未运行和工具不可用;出现失败时调查并修复,不能把未运行项目测试当作通过。
- 完成有意义的功能或遇到阻塞时,在结束回复前使用
project-continuity更新状态、重要变更、验证和下一步;若未安装该 Skill,直接更新项目已有的交接文档。新建的持续开发项目至少留下能定位目标的PROJECT.md,以及写明当前任务、验证结果、阻塞和下一步的STATUS.md、HANDOFF.md;有实际重要改动时记录CHANGES.md。构建或启动未完成也要如实留下检查点,不能只在聊天回复中说明。小型格式或文字修改可保持记录简短。
项目没有 SoloWeave 文件时,沿用现有规范;需要长期协作记录时再建立最少文件。项目记录使用 Markdown,实际检查使用该项目已有的命令;不把人工审阅说成自动化检查通过。