飞机克劳德代码技能
Claude代码管理技能 Plane.so 没有MCP令牌开销的项目。
为什么存在
传统的MCP集成将55+工具模式加载到每个API调用中(约50k个令牌)。该技能使用按需Python脚本,将令牌使用率降低了98.7%。
基于Anthropic的 使用MCP执行代码 研究。
特性
- 55+次操作 涵盖8个类别(项目、工作项、周期、模块、计划、摄入量、属性、用户)
- 零依赖 -仅使用Python标准库
- 渐进式披露 -参考文档仅在需要时加载
- 自我记录 -每个脚本都有
--help
安装
此技能安装 本地 每个项目的 .claude/skills/ 目录。
快速安装(推荐)
将技能库克隆到您的项目中并运行安装脚本:
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脚本可执行
您还可以指定目标目录:
./install.sh /path/to/other/project手动安装
将技能直接复制到您的项目中:
cp -r plane-claude-skill/.claude/skills/plane /path/to/your/project/.claude/skills/卸载
要从项目中删除技能,请执行以下操作:
rm -rf .claude/skills/plane配置
选项1:使用.env文件(推荐)
创建一个 .env 文件在 技能目录 (将Plane配置与项目分开):
cp .claude/skills/plane/.env.example .claude/skills/plane/.env然后编辑 .claude/skills/plane/.env 使用您的凭据:
PLANE_API_KEY=your-api-key
PLANE_WORKSPACE_SLUG=your-workspace
PLANE_BASE_URL=https://api.plane.so选项2:Shell环境变量
或者,在shell中设置环境变量:
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 sprintAdd these three tasks to Sprint 2: setup CI, write tests, deploy直接脚本使用
# 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(所有工具) | ~50000 | 已加载所有55个工具模式 |
| 此技能 | ~300-500 | 仅技能.md描述+脚本输出 |
许可证
麻省理工学院
积分
- 飞机 -开源项目管理
- 人类 -克劳德代码和技能系统
- 基于 官方飞机MCP服务器
