🌟 诺头的专属 AI 技能库 (wenwei-skills)

欢迎来到 wenwei-skills！这里是诺头 (wenwei) 专属定制的技能库。本仓库收集了一系列旨在提升软件开发全生命周期效率的 Cursor / AI 技能 (Skills)。

这些技能覆盖了从需求分析、设计评审、工作量评估，到代码定位、上下文梳理，再到代码审查与提示词复盘的完整研发流程，帮助你更高效、更省心地完成开发工作。

🎯 技能总览

本工作空间包含以下 9 个核心技能，按软件工程生命周期分类如下：

📝 需求与设计阶段 (Requirements & Design)

• 需求分析与对齐助手 (wenwei-requirement-alignment)
  • 适用场景：在正式开发前，基于需求文档进行逻辑推演和边界检查。
  • 核心功能：关联工程代码检查数据流、状态变化，发现逻辑断层与定义模糊之处，确保需求可落地，避免返工。
• 设计评审专家 (wenwei-design-review)
  • 适用场景：概要设计完成后，开发进行前。
  • 核心功能：结合需求与代码现状，评审设计方案的合理性与风险，输出“必须修改”与“建议优化”的分级报告。

📊 工作量评估 (Effort Estimation)

• NESMA 工作量拆分工作流 (wenwei-nesma)
  • 适用场景：需要基于 NESMA 标准对需求进行工作量评估与报价。
  • 核心功能：自动化执行功能点摸底、NESMA 拆解 (EI/EO/EQ/ILF/EIF)、交叉审查，并导出 CSV 与包含人天换算的工作量估算文档。
• COSMIC 工作量拆分工作流 (wenwei-cosmic)
  • 适用场景：需要基于 COSMIC 标准对需求进行工作量评估。
  • 核心功能：将需求文档自动拆解为功能点与子过程明细（E/R/W/X 数据移动），支持导出 CSV 供后续测算。

💻 代码开发与理解 (Code Dev & Context)

• 代码知识库生成器 (wenwei-context-build)
  • 适用场景：接手新模块或分析复杂代码逻辑时。
  • 核心功能：从入口文件递归追踪调用链，梳理前后端代码结构与依赖，生成结构化的技术上下文文档。
• 需求驱动的代码定位 (wenwei-code-positioning)
  • 适用场景：排查 Bug 或寻找特定需求逻辑的实现位置时。
  • 核心功能：根据问题描述和入口，精准向业务逻辑收敛，输出关键代码片段和调用链，避免漫无目的地全局搜索。

🔎 代码审查 (Code Review)

• 提交前代码检查专家 (wenwei-commit-review)
  • 适用场景：Git Commit 提交之前。
  • 核心功能：基于 git diff 逐文件排查潜在 BUG（如空指针、越界）、安全风险与可优化项，提供轻量级的提交前质量把关。
• 代码评审专家 (wenwei-code-review)
  • 适用场景：功能开发完成后，测试开始前。
  • 核心功能：对照需求文档和概要设计，严格审查代码的完整性与一致性，精准识别偏离设计或未完成的事项。

💡 协作与复盘 (Collaboration & Improvement)

• 提示词复盘助手 (wenwei-prompt-review)
  • 适用场景：一段完整的开发会话结束后，希望提升 AI 协作技巧。
  • 核心功能：从结果导向和协作效率视角复盘用户的提示词，给出 "原版 vs 优化版" 的改写对比与共性问题改进建议。

🚀 如何使用

在 Cursor 等支持自定义 Agent Skill 的 IDE 中，当本仓库作为工作空间或被正确引入后，只需在对话中提及相关意图即可自动触发。

触发示例：

• "帮我做一下提交前检查" ➡️ 触发 wenwei-commit-review
• "根据这个需求文档做一下 NESMA 拆解" ➡️ 触发 wenwei-nesma
• "复盘一下这次对话的提示词" ➡️ 触发 wenwei-prompt-review

---