|
|
|
每天都在被AI生成的代码搞得返工?试试这个Brainstorming Skill
超强「头脑风暴」Skill,用于在写代码/做功能前先梳理需求、设计方案、分段确认,避免返工。
GitHub 下载/查看详情: http://t.cn/AXcDcaEc
一、核心作用 / 目标
核心目的:在任何创意性工作开始之前,强制完成结构化设计确认。
适用范围包括:
* 新功能开发
* 组件构建
* 行为修改
* 架构调整
它明确反对“直接写代码”。
核心目标:
* 防止基于未验证假设直接实现
* 避免返工
* 减少架构债务
* 提升可维护性
即使任务看起来很简单,也必须走完整设计关卡(no exceptions)。
---
二、核心机制
它本质上是:结构化设计对话流程 + 严格的流程守门机制
主要包含以下强制规则:
1️⃣ 强制前置设计阶段
所有创意任务必须先进入 brainstorming 阶段。
---
2️⃣ 上下文探索
必须先了解当前项目状态:
* 代码结构
* 文档
* 最近 git 提交
* 现有实现方式
禁止“盲设计”。
---
3️⃣ 逐一澄清
规则非常严格:
* 一次只问一个问题
* 优先使用选择题
* 避免开放式信息轰炸
目标是降低认知负担。
---
4️⃣ 方案对比机制
必须提出:
* 2–3 个实现方案
* 每个方案的优劣(trade-offs)
* 明确推荐一个
强制多路径思考,避免单一假设。
---
5️⃣ 分段设计呈现
按复杂度分块展示设计,例如:
* 架构层
* 组件设计
* 数据流
* 错误处理
* 测试策略
每一段都必须得到用户确认,若未通过,必须修改后重新呈现。
---
6️⃣ 产出设计文档
全部确认后:
* 写入 docs/plans/YYYY-MM-DD-xxx-design.md
* 提交 commit
设计必须可追溯。
---
7️⃣ 单一出口机制
设计完成后:
只能调用 writing-plans 技能。
严禁直接进入实现类技能。
这是流程纪律的核心。
---
三、完整流程(类似有限状态机)
开始
↓
探索上下文(代码 / 文档 / git)
↓
逐一澄清问题(一次一个)
↓
提出 2–3 个方案 + 优劣分析 + 推荐
↓
分段展示详细设计
├─ 未通过 → 修改并重新展示
└─ 全部通过
↓
写入 docs/plans/ 目录并 commit
↓
调用 writing-plans 技能
↓
结束(进入实施阶段)
不允许绕过,不允许跳步骤,不允许提前写代码
---
四、总结
这是一个高度纪律化、反直觉跳步骤、反“快手写代码”的软件设计对话框架。
目标是:用结构化对话,把模糊想法转化为经过验证、可追溯、可维护的设计文档,然后才允许进入实施阶段。
它适合:
* 长期项目
* 多人协作
* 高质量要求场景
* 需要复盘与可维护性的系统
#
|
本帖子中包含更多资源
您需要 登录 才可以下载或查看,没有账号?立即注册
×
|