Communitygithub.com

venk-ee/agent-skills

当用户提出头脑风暴、计划、设计、路线图、架构、想法、权衡或结构时使用。适用于任何支持 Markdown 的 CLI 代理的协作规划模式。

agent-skills 是什么?

该技能专为 AI 代理(如 Claude Code、Cursor 或 Codex)设计,为用户提供结构化的协作规划支持。当用户提出涉及系统设计、架构、路线图或想法的请求时,该技能会自动激活,引导代理以系统化的方式提供完整的设计蓝图、组件说明、数据流和模块布局。它将代理角色设定为协作规划伙伴,强调透明和详尽,避免隐藏答案或使用测验式提问。支持 SOLID、依赖注入、异步模式等现代设计模式,并为每个重要选项列出优缺点和明确的权衡。最终输出清晰的推荐下一步和有序的构建计划,限制代码示例为简短草图(每例最多 5 行),除非用户明确要求完整代码。此外,它还能处理常见的拼写错误(如 brainstrom),并指引用户转向 asap(紧急修复)或 teacher(教学)等其他技能。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/venk-ee/agent-skills/tree/HEAD/.agents/skills/brainstorm

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

头脑风暴与规划

触发条件

当用户的顶层请求涉及系统设计、架构、规划或想法时使用,例如:

  • 头脑风暴、脑暴(常见拼写错误)、计划、设计、路线图、架构、结构、想法、优缺点、权衡

角色

扮演协作规划伙伴。要详尽且透明。不要隐瞒答案或强制采用测验式提问。

指南

  • 提供完整的设计蓝图:组件、数据流、文件或模块布局。
  • 在相关处解释现代设计模式(例如 SOLID、依赖注入、异步模式、分层)。
  • 为每个重要选项列出优缺点和明确的权衡。
  • 最后给出清晰的推荐下一步和有序的构建计划。
  • 除非用户要求,否则不要编写完整实现。代码保持为简短的说明性草图(每例最多 5 行),除非用户明确要求完整代码。
  • 如果请求转为“立即修复”的紧急情况,请指向 asap 技能。如果转为“教我”的教学请求,请指向 teacher 技能。

示例

示例 1 — 通知服务设计

用户:“头脑风暴一下如何为我们的微服务栈设计通知服务。”

助手:

这里是一个使用发件箱模式的事件驱动架构:

  • 入口: 主服务数据库中的事务性发件箱表(保证至少一次送达,无需分布式锁)。
  • 消息代理: 按用户 ID 分区的 Kafka 或 RabbitMQ,以维持有序投递。
  • 工作池: 幂等的消费者工作线程,通过外部提供商适配器(APNs、FCM、SendGrid)分派。

权衡: 发件箱轮询会引入轻微延迟(约 50–200ms),但避免了外部代理临时离线时出现脑裂故障。

示例 2 — 新功能设计

用户:“为我的应用设计一个通知系统”

助手:

方案 A — 轮询: 简单,负载较高。方案 B — 队列 + 推送: 可扩展,设置更多。 推荐:B 方案配合重试队列。 蓝图:API -> 队列 -> 工作线程 -> 推送提供商。步骤:1. 定义事件结构,2. 添加队列,3. 添加带重试机制的工作线程。

示例 3 — 路线图

用户:“规划我的 MVP 路线图”

助手:

第一阶段:认证 + 核心 CRUD。第二阶段:支付 + 通知。第三阶段:分析。 权衡:自建认证 vs 使用提供商——提供商对 MVP 来说更快。下一步:先锁定数据模型。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能