spec-agent-skills

spec-dev-skills

面向 Claude Code 和 Codex 的功能开发 skills 集合，包含系统化的功能开发与需求分析工作流。

中文版 | 融合 ultrathink 深度分析 | MCP 工具增强 | 语言无关

特性

• 双工作流系统: 7 阶段完整开发 + 9 阶段需求分析，灵活适配不同场景
• Task List 智能管理: 进度可视化、工作流透明化、断点恢复、任务可复用
• 双模式架构设计: feat-dev 支持单方案快速设计 vs 多方案对比（复杂需求）
• ultrathink 深度分析: 在关键决策点使用 Sequential Thinking 进行结构化思考
• 灵活并行模式: 探索阶段 2-5 agents，审查阶段 3-5 agents，自适应需求复杂度
• MCP 工具增强: 集成 context7、exa、sequential-thinking（可选，智能降级）
• 3 个专门化 Agents: code-explorer、code-architect、code-reviewer（支持子任务跟踪）
• 语言无关: 适用于任何编程语言和项目结构
• 中文输出: 全程中文沟通

MCP 工具增强（推荐但可选）

🎯 重要说明

本插件的所有功能在没有 MCP 的情况下也能正常工作！

插件使用智能降级策略，当 MCP 不可用时自动切换到备用方案：

使用体验对比

🚀 快速开始（无需配置）

# 添加为 marketplace
/plugin marketplace add https://github.com/FlameMida/spec-dev

# 安装 skill 包
/plugin install spec-dev@spec-agent-skills

/requirement-analysis 分析用户权限系统的实现方案

{
   "mcpServers": {
      "context7": {
         "command": "npx",
         "args": [
            "-y",
            "@upstash/context7-mcp"
         ],
         "env": {
            "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}"
         }
      },
      "exa": {
         "type": "http",
         "url": "https://mcp.exa.ai/mcp?exaApiKey=${EXA_API_KEY}"
      },
      "sequential-thinking": {
         "command": "npx",
         "args": [
            "-y",
            "@modelcontextprotocol/server-sequential-thinking"
         ]
      }
   }
}

/check-mcp

git clone https://github.com/FlameMida/spec-dev.git
cp spec-dev ~/.codex/skills/
codex

使用需求分析skill，分析用户权限系统的实现方案

/check-mcp

直接使用 skills，无需任何 MCP 配置即可获得完整功能（降级方案自动生效）。

通用环境变量（MCP 可选）

在 ~/.zshrc（macOS/Linux）或 ~/.bashrc（Linux）或系统环境变量（Windows）中添加：

export CONTEXT7_API_KEY="your-context7-api-key"
export EXA_API_KEY="your-exa-api-key"

获取 API Key：

• Context7: https://context7.com/
• Exa: https://exa.ai/

⚠️ 关于 MCP 重复安装

如果您：

• ✅ 已在全局配置中安装了这些 MCP - 完美，直接使用
• ✅ 不想安装 MCP - 没问题，降级方案自动生效
• ✅ 部分安装了 MCP - 已有的 MCP 会被使用，其他功能降级

使用方法

本插件提供两个主要 skill，可根据需求选择使用：

Skill 对比

如何选择

选择 feat-dev 当你需要：

• ✅ 完整实施一个新功能
• ✅ 修改多个核心模块
• ✅ 需要对比多种架构方案
• ✅ 需要自动化的代码审查
• ✅ 从设计到交付的完整流程

选择 requirement-analysis 当你需要：

• ✅ 快速分析技术方案可行性
• ✅ 设计 API 或数据库架构
• ✅ 评估实施复杂度
• ✅ 先看计划再决定是否实施
• ✅ 需要研究外部资源和最佳实践

1. feat-dev - 完整功能开发工作流

适用场景：复杂功能开发、多模块实施、需要架构设计的任务

使用方式（Claude Code）：

/feat-dev 实现用户认证功能

使用方式（Codex）：

使用 feat-dev skill，实现用户认证功能

工作流程：7 个完整阶段（需求理解 → 代码探索 → 澄清问题 → 架构设计 → 实施 → 质量审查 → 总结）

示例：

/feat-dev 实现一个支持多租户的订单管理系统，包括订单创建、状态跟踪和报表统计功能

2. requirement-analysis - 需求分析工作流

适用场景：快速需求分析、前期设计规划、需要深度分析但不立即实施的场景

使用方式（Claude Code）：

/requirement-analysis 分析用户权限系统的实现方案

使用方式（Codex）：

使用需求分析skill，分析用户权限系统的实现方案

工作流程：9 个完整阶段（需求理解 → 代码探索 → 外部资源研究 → 澄清问题 → 深度分析 → 展示计划 → 可选实施 → 可选审查 → 总结）

示例：

分析如何集成第三方支付系统（支付宝、微信支付），提供技术方案, 使用需求分析skill

专门化 Agents

本插件使用三个专门化 agents 提升效率和质量，所有 agents 都支持子任务跟踪。

并行策略

何时使用并行：

• ✅ 需求涉及多个架构层次或模块
• ✅ 探索任务可以清晰分解
• ✅ 需要节省时间，提高效率

并行数量建议：

• 简单需求：1 个 agent
• 中等需求：2-3 个 agents
• 复杂需求：3-5 个 agents
• ⚠️ 不建议超过 5 个并行任务

探索阶段分解策略：

• 按架构层次：数据层、服务层、API层
• 按功能模块：核心模块、关联模块
• 按关注点：现有实现、错误处理、测试、配置

feat-dev 的 7 阶段工作流