飞机克劳德代码技能

Claude代码管理技能 Plane.so 没有MCP令牌开销的项目。

为什么存在

传统的MCP集成将55+工具模式加载到每个API调用中（约50k个令牌）。该技能使用按需Python脚本，将令牌使用率降低了98.7%。

基于Anthropic的 使用MCP执行代码 研究。

特性

• 55+次操作 涵盖8个类别（项目、工作项、周期、模块、计划、摄入量、属性、用户）
• 零依赖 -仅使用Python标准库
• 渐进式披露 -参考文档仅在需要时加载
• 自我记录 -每个脚本都有 --help

安装

此技能安装 本地 每个项目的 .claude/skills/ 目录。

快速安装（推荐）

将技能库克隆到您的项目中并运行安装脚本：```bash
cd /path/to/your/project
git clone https://github.com/clarityreg/plane-claude-skill.git
cd plane-claude-skill
./install.sh

脚本将：

- 安装到 **父目录** （您的项目）默认情况下
- 创建 `.claude/skills/` 如果它不存在
- 复制 `.env.example` 到您的项目根目录
- 使Python脚本可执行

您还可以指定目标目录：```bash
./install.sh /path/to/other/project

手动安装

将技能直接复制到您的项目中：```bash
cp -r plane-claude-skill/.claude/skills/plane /path/to/your/project/.claude/skills/

### 卸载

要从项目中删除技能，请执行以下操作：```bash
rm -rf .claude/skills/plane

配置

选项1：使用.env文件（推荐）

创建一个 .env 文件在 技能目录 （将Plane配置与项目分开）：```bash
cp .claude/skills/plane/.env.example .claude/skills/plane/.env

然后编辑 `.claude/skills/plane/.env` 使用您的凭据：```env
PLANE_API_KEY=your-api-key
PLANE_WORKSPACE_SLUG=your-workspace
PLANE_BASE_URL=https://api.plane.so

选项2:Shell环境变量

或者，在shell中设置环境变量：```bash
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace"
export PLANE_BASE_URL="https://api.plane.so" # or your self-hosted URL

> **注：** Shell环境变量优先于 `.env` 文件值。

## 用法

### 自然语言（通过克劳德）```
Create a new project called "API Redesign" with identifier "API"
``````
Show me all work items in the current sprint
``````
Add these three tasks to Sprint 2: setup CI, write tests, deploy

直接脚本使用```bash

Projects

python ~/.claude/skills/plane/scripts/projects.py list
python ~/.claude/skills/plane/scripts/projects.py create --name "My Project" --identifier "MP"

Work Items

python ~/.claude/skills/plane/scripts/work_items.py list
python ~/.claude/skills/plane/scripts/work_items.py create --name "Task" --priority high

Cycles (Sprints)

python ~/.claude/skills/plane/scripts/cycles.py create --name "Sprint 1" --start "2025-01-27" --end "2025-02-07"
python ~/.claude/skills/plane/scripts/cycles.py add-items --items "item1,item2"

And more...

## 结构```
.claude/skills/plane/
├── SKILL.md              # Main skill entry point
├── .env.example          # Template for configuration
├── scripts/              # Python scripts for each category
│   ├── plane_api.py      # Core API client
│   ├── projects.py       # Project operations
│   ├── work_items.py     # Work item operations
│   ├── cycles.py         # Sprint/cycle operations
│   ├── modules.py        # Module operations
│   ├── initiatives.py    # Initiative operations
│   ├── intake.py         # Intake triage operations
│   ├── properties.py     # Custom property operations
│   └── users.py          # User operations
├── references/           # Detailed documentation
│   ├── tools.md          # Complete tool reference
│   ├── schemas.md        # API data structures
│   └── workflows.md      # Common task patterns
└── examples/             # Usage examples
└── sprint_setup.md   # Full sprint setup guide

代币效率

许可证

麻省理工学院

积分

• 飞机 -开源项目管理
• 人类 -克劳德代码和技能系统
• 基于 官方飞机MCP服务器