AgentSkillsCN

mcpx-getting-started

适用于在 MCPX 项目中启动任何工作时使用。加载所有必需的 MCPX 工作流程技能。

SKILL.md
--- frontmatter
name: mcpx-getting-started
description: Use when starting any work on the MCPX project. Loads all required MCPX workflow skills.

MCPX Getting Started

Overview

MCPX 项目使用 skills 规范 AI 开发流程,而非人类文档。

Required Skills

开发 MCPX 时必须加载以下 skills:

bash
# 这些 skills 在 .claude/skills/ 目录
mcpx-tdd-workflow      # TDD 开发流程(RED-GREEN-REFACTOR)
mcpx-code-quality      # 代码质量检查(lint/types/test)
mcpx-documentation     # 文档更新规范
mcpx-release           # 版本发布流程

Development Flow

code
1. 开始任务
   ↓
2. 加载 mcpx-tdd-workflow
   ↓ 先写失败的测试
3. 实现代码
   ↓ RED → GREEN → REFACTOR
4. 加载 mcpx-code-quality
   ↓ lint + types + test
5. 加载 mcpx-documentation
   ↓ 更新文档
6. 准备发布时加载 mcpx-release

Quick Reference

阶段Skill命令
开发mcpx-tdd-workflowuv run pytest tests/ -v
检查mcpx-code-qualityuv run ruff check && uv run mypy
文档mcpx-documentation更新 CLAUDE.md/README.md
发布mcpx-releasegit tag v0.x.x

Installing Skills

复制项目 skills 到个人目录:

bash
cp -r .claude/skills/* ~/.claude/skills/

Project Context

  • 语言: Python 3.12+
  • 框架: FastMCP 3.0
  • 包管理: uv
  • 测试: pytest + pytest-asyncio
  • 覆盖率要求: ≥ 70%

查看 CLAUDE.md 获取完整架构信息。