asana

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Asana Skill

Asana Skill

Overview

概述

Claude can manage your Asana workspace to create projects, organize tasks, track progress, and coordinate team work. Supports multiple views including list, board, timeline, and calendar.
Claude可以管理你的Asana工作区,创建项目、组织任务、跟踪进度并协调团队工作。支持列表、看板、时间线和日历等多种视图。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/asana/install.sh | bash
Or manually:
bash
cp -r skills/asana ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/asana/install.sh | bash
或手动安装:
bash
cp -r skills/asana ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置:
bash
undefined

First, ensure canifi-env is installed:

首先,确保已安装canifi-env:

canifi-env set ASANA_EMAIL "your-email@example.com"
undefined
canifi-env set ASANA_EMAIL "your-email@example.com"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据,由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1:手动浏览器登录(推荐)

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭据:
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用你的已认证会话,且绝不会获取你的密码

Option 2: Environment Variables

选项2:环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据,可以将其存储在本地:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意:存储在canifi-env中的凭据仅能在你的本地机器上访问,绝不会被传输。

Capabilities

功能

  • Create and manage projects
  • Add and organize tasks
  • Create subtasks
  • Set due dates and assignees
  • Track project progress
  • Use custom fields
  • Add task dependencies
  • View timeline/Gantt
  • Create milestones
  • Add comments and attachments
  • Use project templates
  • Generate status reports
  • 创建和管理项目
  • 添加和组织任务
  • 创建子任务
  • 设置截止日期和任务负责人
  • 跟踪项目进度
  • 使用自定义字段
  • 添加任务依赖
  • 查看时间线/甘特图
  • 创建里程碑
  • 添加评论和附件
  • 使用项目模板
  • 生成状态报告

Usage Examples

使用示例

Example 1: Create Task

示例1:创建任务

User: "Add a task 'Prepare presentation' to the Marketing project"
Claude: Opens project, creates task with title.
        Confirms: "Task 'Prepare presentation' added to Marketing"
用户:“将任务‘准备演示文稿’添加到营销项目中”
Claude:打开项目,创建带有指定标题的任务。
        确认:“任务‘准备演示文稿’已添加到营销项目”

Example 2: View Project Status

示例2:查看项目状态

User: "What's the status of the Product Launch project?"
Claude: Opens project, analyzes tasks.
        Reports: "Product Launch: 65% complete. 13 tasks done,
        7 in progress, 5 pending. Next milestone: Beta Release (3 days)"
用户:“产品发布项目的状态如何?”
Claude:打开项目,分析任务情况。
        汇报:“产品发布项目:完成65%。已完成13项任务,
        7项进行中,5项待处理。下一个里程碑:Beta版本发布(3天后)”

Example 3: Assign Task

示例3:分配任务

User: "Assign the UX review task to Sarah with Friday deadline"
Claude: Finds task, assigns to Sarah, sets due date.
        Confirms: "Assigned to Sarah, due Friday"
用户:“将UX评审任务分配给Sarah,截止日期为周五”
Claude:找到任务,分配给Sarah并设置截止日期。
        确认:“已分配给Sarah,截止日期为周五”

Example 4: Create Project

示例4:创建项目

User: "Create a new project for the website redesign"
Claude: Creates project "Website Redesign" with sections.
        Returns: "Project created with default sections"
用户:“为网站重新设计创建一个新项目”
Claude:创建名为“网站重新设计”的项目并添加分区。
        返回:“项目已创建,包含默认分区”

Authentication Flow

认证流程

  1. Claude navigates to app.asana.com via Playwright MCP
  2. Enters ASANA_EMAIL for authentication
  3. Handles 2FA if required (notifies user via iMessage)
  4. Maintains session for project operations
  1. Claude通过Playwright MCP导航至app.asana.com
  2. 输入ASANA_EMAIL进行认证
  3. 如需双因素认证则处理(通过iMessage通知用户)
  4. 维持会话以进行项目操作

Selectors Reference

选择器参考

javascript
// Sidebar
'.SidebarWorkspaceDropdownButton'

// Project list
'.SidebarNavigationLinkList'

// Task list
'.TaskList'

// Task row
'.TaskRow'

// Add task button
'.AddTaskButton'

// Task name input
'.TaskName-input'

// Assignee
'.TaskAssigneeField'

// Due date
'.DueDateField'

// Project header
'.ProjectHeader'

// Sections
'.TaskListSectionRow'

// Timeline view
'.Timeline'
javascript
// 侧边栏
'.SidebarWorkspaceDropdownButton'

// 项目列表
'.SidebarNavigationLinkList'

// 任务列表
'.TaskList'

// 任务行
'.TaskRow'

// 添加任务按钮
'.AddTaskButton'

// 任务名称输入框
'.TaskName-input'

// 任务负责人
'.TaskAssigneeField'

// 截止日期
'.DueDateField'

// 项目标题
'.ProjectHeader'

// 分区
'.TaskListSectionRow'

// 时间线视图
'.Timeline'

Error Handling

错误处理

  • Login Failed: Retry 3 times, notify user via iMessage
  • Session Expired: Re-authenticate automatically
  • Project Not Found: List available projects, ask user
  • Task Create Failed: Retry, verify project access
  • Assignment Failed: Verify member is in workspace
  • Permission Denied: Notify user of access issue
  • 登录失败:重试3次,通过iMessage通知用户
  • 会话过期:自动重新认证
  • 项目未找到:列出可用项目,询问用户
  • 任务创建失败:重试,验证项目访问权限
  • 任务分配失败:验证成员是否在工作区内
  • 权限被拒绝:通知用户存在访问问题

Self-Improvement Instructions

自我改进说明

When you learn a better way to accomplish a task with Asana:
  1. Document the improvement in your response
  2. Suggest updating this skill file with the new approach
  3. Include specific project management workflows
  4. Note useful custom field configurations
当你学会使用Asana完成任务的更好方法时:
  1. 在回复中记录改进点
  2. 建议使用新方法更新此Skill文件
  3. 包含具体的项目管理工作流
  4. 记录有用的自定义字段配置

Notes

注意事项

  • Multiple views: list, board, timeline, calendar
  • Custom fields for project-specific data
  • Rules for automation
  • Forms for task intake
  • Goals for OKR tracking
  • Portfolios for project oversight
  • Workload view for capacity planning
  • Templates for repeatable projects
  • 多种视图:列表、看板、时间线、日历
  • 用于项目特定数据的自定义字段
  • 用于自动化的规则
  • 用于任务收集的表单
  • 用于OKR跟踪的目标
  • 用于项目监督的项目组合
  • 用于容量规划的工作量视图
  • 用于可重复项目的模板