自适应 Vibe Coding 工程治理
使用这个 Skill,让 vibe coding 项目保持快速,同时避免技术选型和工程实现变得随机。核心原则:先识别项目,再按风险选择最轻但足够的工程治理。
这套指导不只适用于 Codex,也可用于 WorkBuddy、Qoderwork 或类似智能体开发应用。
工作流程
- 建立项目画像。
- 判断项目类型、规模和风险等级。
- 推荐实现路线,并解释原因。
- 记录重要架构决策。
- 应用基础工程标准。
- 应用基于风险的交付门禁。
- 生成面向维护人的简洁交接摘要。
如果用户没有明确技术要求,且没有明显更优方案,优先考虑常用基线技术栈:Java、Python、Vue、UniApp、PostgreSQL/PgSQL、MySQL、Redis。这是默认优先项,不是硬性限制。
引用文件路由
只读取当前任务需要的引用文件:
- 项目画像、规模和风险:
references/project-classification.md - 技术选型和默认路线:
references/technology-routes.md - 按风险等级的交付门禁:
references/governance-gates.md - 架构决策记录:
references/adr-template.md - 事业部本地策略和例外:
references/business-unit-policy.md
新项目通常读取项目分类、技术路线和治理门禁。R2/R3 项目或存在非显而易见技术选择时,也读取 ADR 模板。有事业部本地规则时,再读取事业部策略格式。
操作规则
- 不要为所有项目强制指定同一个技术栈。
- 不要在识别项目之前推荐技术栈。
- 不要平均风险等级;取最高适用风险。
- 不要因为流行趋势引入陌生技术。
- 不要永久阻塞用户;记录风险并给出更安全路径。
- 不要在 Skill 输出中保存机密业务数据。
输出约定
多数任务按以下结构输出:
- 项目画像和假设。
- 项目类型、规模和风险等级。
- 推荐技术栈和理由。
- 被拒绝的备选方案及原因。
- 必要治理门禁。
- 下一步实施或评审动作。
对于 R2/R3 项目,或推荐集团基线技术栈之外的技术时,生成 ADR 或 ADR 草稿。
常见错误
| 错误 | 修正 |
|---|---|
| 未了解数据敏感度就推荐技术栈 | 先建立项目画像。 |
| 把原型和核心业务系统按同一标准处理 | 使用规模和风险门禁分级处理。 |
| 因为新框架流行就推荐它 | 优先考虑可维护性和运维熟悉度。 |
| 认为用户少就一定低风险 | 敏感数据或外部暴露会把风险提高到 R3。 |
| 例外不留痕 | 在 ADR 或交接摘要中记录例外。 |