cs-decide 启动必读 开始任何判断或动作前,先读取 ;缺失则视为骨架不完整,提示先补齐或运行 ,不要回退到外部 AI 入口文件。 项目里"有意做出的选择"——技术选型 / 架构决定 / 长期约束 / 编码规约——特别容易丢失。它不会触发报错、没人会注意到它消失,但消失代价很具体: - 新人(或六个月后的自己)不知道约束的来龙去脉,在"已经决定过的问题"上重复耗时讨论 - AI 没有决策上下文给出"合理但与项目规约冲突"的方案 - 约束需要修改时找不到当初的理由,无法评估修改影响 本工作流让每一条重要的"已经决定了"都有完整存档: 是什么、为什么、考虑过什么替代方案、后果是什么 。 共享路径与命名约定看 。产物写入 ,命名 ,frontmatter 带 。 --- 四种决策类型 每条归属四类之一(frontmatter 的 字段标注): | 类型 | 适用情境 | 示例 | |---|---|---| | | 技术 / 库 / 框架的选型 | "用 Vite 而非 Webpack"、"状态管理用 Pinia" | | | 系统结构、模块划分、数据流方向 | "前后端完全分离"、"事件总线只在顶层使用" | | | 硬约束——某些事情 不允许 做 | "不引入 jQuery"、"所有 API 调用必须通过统一的 http 模块" | | | 软规约——某些事情 统一这样做 |…