【自動化】 ラベルから TODO を自動生成する方法

手動作業からの解放。僕が実践する 「ラベル → TODO 自動化」 の全工程

「また手動で TODO を作成するの？」

フリーランス開発者として 14 年間、この繰り返し作業に何度も心が折れそうになりました。

GitHub Issues にラベルを付けるたびに、Todoist に手動で TODO を追加する。

一見簡単な作業ですが、これが積み重なると、想像以上の時間と集中力を奪われます。

でも、ある日気づいたんです。

「この作業、絶対に自動化できるはず」と。

今日は、僕が実際に使っている「GitHub Issues のラベル → Todoist の TODO 自動生成」パイプラインを、設計から実装、応用編まで一気通貫でお伝えします。

手動作業からの解放。その先にある、本当に価値のある仕事に集中できる時間を、あなたも手に入れてみませんか？

なぜ僕は 「ラベル → TODO 自動化」 を選んだのか？

フリーランス開発者として、プロジェクト管理は生命線です。

でも、従来の方法では限界を感じていました。

従来の課題

1. 手動作業の非効率性

この一連の流れを、毎回手動で行うのは時間の無駄でした。

一見簡単な作業ですが、これが積み重なると想像以上の時間を奪われます。

特に複数のプロジェクトを並行して進めていると、1 日に何度もこの作業を繰り返すことになり、1 日の作業時間の 10% 以上をタスク管理に費やしてしまうこともありました。

しかも、この作業は創造的な価値を生み出さない、単純な繰り返し作業なのです。

2. 情報の不整合

最も深刻だったのは、この「情報の分断」です。GitHub で Issue の進捗を確認し、Todoist でタスクの状況を把握する。

この二重管理により、どちらが最新の情報なのかわからなくなることが頻繁にありました。

特に、クライアントとの打ち合わせで「このタスクの進捗はどうですか？」と聞かれたとき、どちらのツールを確認すればいいのか迷ってしまう。

そんな経験を何度もしました。

3. 集中力の分散

開発に没頭している最中に、突然「あ、このタスクを Todoist に追加しなきゃ」と気づいて、作業を中断する。

この瞬間、それまで築き上げていた思考の流れが完全に断ち切られてしまいます。再び集中状態に戻るまでに 15 分、場合によっては 30 分かかることもありました。

この「集中力の分散」こそが、フリーランス開発者にとって最も大きな損失だったのです。

自動化で得られる価値

1. 時間の節約

これまで毎回 5 分かかっていた手動作業が、ラベルを付けるだけで瞬時に完了するようになりました。

単純計算でも、1 日 10 回のタスク作成で 50 分の時間を節約。1 ヶ月では 20 時間以上の時間を生み出せるのです。

2. 情報の一元化

GitHub Issues を「真実のソース」として位置づけることで、情報の重複や不整合が完全に解消されました。

プロジェクトの進捗状況を GitHub で確認し、実行すべきタスクは Todoist で管理する。

この明確な役割分担により、迷いなく作業に集中できる環境が整ったのです。

3. 集中力の維持

最も価値が高いのは、この「集中力の維持」です。

開発に没頭している最中に、タスク管理ツールを切り替える必要がなくなりました。

思考の流れが中断されることなく、創造的な作業に集中し続けられる。これこそが、自動化の真の価値なのです。

今日作る自動化パイプラインの全体像

システム構成

GitHub Issues (ラベル付与)
    ↓
GitHub Actions (トリガー)
    ↓
Todoist API (TODO作成)
    ↓
Obsidian (記録・分析)

このシンプルな 4 段階のパイプラインが、僕の手動作業を完全に自動化してくれます。

GitHub Issues でラベルを付けるだけで、Todoist に TODO が自動生成され、Obsidian でその記録を分析できる。まるで魔法のような仕組みですが、実は各段階で確実に動作する、信頼性の高いシステムなのです。

主要コンポーネント

1. GitHub Actions Workflow

GitHub Actions は、この自動化の心臓部です。

Issue にラベルが付与された瞬間を検知し、条件に応じて次のステップに進む。まるで「見張り番」のような役割を果たしてくれます。

僕が何も考えずにラベルを付けるだけで、システムが自動的に判断してくれるのです。

2. Todoist API 連携

Todoist API との連携により、単なる TODO 作成を超えた、高度なタスク管理が実現されます。

プロジェクトの自動作成、期限の自動計算、優先度の設定など、手動では面倒な作業をすべて自動化。

これにより、僕は「何を作るか」に集中でき、「どう管理するか」はシステムに任せられるようになりました。

3. Obsidian 連携

最後に、Obsidian による記録と分析機能。自動化の効果を数値で確認し、改善点を見つけ出す。

これにより、システムは単なる「便利ツール」から「成長するパートナー」へと進化します。

毎日の自動化ログを見るたびに、どれだけの時間を節約できているかを実感できるのです。

ステップ 1: GitHub Actions Workflow の基本設計

ワークフローファイルの作成

`.github/workflows/label-to-todo.yml` を作成します:

name: Label to Todo Automation

on:
  issues:
    types: [labeled, unlabeled]
  issue_comment:
    types: [created]

jobs:
  create-todo:
    if: github.event.label.name == 'todo' || github.event.label.name == 'bug' || github.event.label.name == 'enhancement'
    runs-on: ubuntu-latest
    
    steps:
    - name: Checkout repository
      uses: actions/checkout@v4
      
    - name: Setup Node.js
      uses: actions/setup-node@v4
      with:
        node-version: '18'
        
    - name: Install dependencies
      run: npm install @doist/todoist-api-typescript
      
    - name: Create Todoist task
      env:
        TODOIST_API_TOKEN: ${{ secrets.TODOIST_API_TOKEN }}
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      run: |
        node scripts/create-todo.js

基本的なスクリプト実装

`scripts/create-todo.js`:

const { TodoistApi } = require('@doist/todoist-api-typescript');

async function createTodoFromIssue() {
  const api = new TodoistApi(process.env.TODOIST_API_TOKEN);
  
  const issue = context.payload.issue;
  const label = context.payload.label;
  
  // プロジェクト名を生成
  const projectName = `GitHub: ${context.payload.repository.name}`;
  
  // プロジェクトを取得または作成
  let project = await findOrCreateProject(api, projectName);
  
  // TODO を作成
  const task = await api.addTask({
    content: `[GitHub] ${issue.title}`,
    project_id: project.id,
    description: `Issue: ${issue.html_url}\n\n${issue.body}`,
    due_string: calculateDueDate(label.name),
    labels: [label.name]
  });
  
  console.log(`Created task: ${task.id}`);
}

function calculateDueDate(labelName) {
  const dueDateMap = {
    'urgent': 'today',
    'high': 'tomorrow',
    'medium': 'next week',
    'low': 'next month'
  };
  
  return dueDateMap[labelName] || 'next week';
}

async function findOrCreateProject(api, projectName) {
  const projects = await api.getProjects();
  let project = projects.find(p => p.name === projectName);
  
  if (!project) {
    project = await api.addProject({
      name: projectName,
      color: 'blue'
    });
  }
  
  return project;
}

createTodoFromIssue().catch(console.error);

ステップ 2: 高度な機能の実装

ラベル別の詳細設定

const labelConfig = {
  'bug': {
    priority: 4,
    dueString: 'today',
    labels: ['bug', 'github'],
    projectSuffix: 'Bugs'
  },
  'enhancement': {
    priority: 3,
    dueString: 'next week',
    labels: ['enhancement', 'github'],
    projectSuffix: 'Features'
  },
  'documentation': {
    priority: 2,
    dueString: 'next month',
    labels: ['documentation', 'github'],
    projectSuffix: 'Docs'
  }
};

async function createDetailedTodo(issue, label) {
  const config = labelConfig[label.name] || labelConfig['enhancement'];
  
  const task = await api.addTask({
    content: `[${label.name.toUpperCase()}] ${issue.title}`,
    project_id: await getProjectId(config.projectSuffix),
    description: generateDescription(issue),
    priority: config.priority,
    due_string: config.dueString,
    labels: config.labels,
    section_id: await getSectionId(label.name)
  });
  
  return task;
}

function generateDescription(issue) {
  return `
## GitHub Issue
- **URL**: ${issue.html_url}
- **Number**: #${issue.number}
- **Author**: ${issue.user.login}
- **Created**: ${new Date(issue.created_at).toLocaleDateString()}

## Description
${issue.body || 'No description provided'}

## Labels
${issue.labels.map(l => `- ${l.name}`).join('\n')}
  `.trim();
}

セクション管理の実装

async function getSectionId(sectionName) {
  const sections = await api.getSections();
  let section = sections.find(s => s.name === sectionName);
  
  if (!section) {
    section = await api.addSection({
      name: sectionName,
      project_id: await getProjectId('Main')
    });
  }
  
  return section.id;
}

ステップ 3: エラーハンドリングとログ管理

堅牢なエラーハンドリング

class TodoAutomationError extends Error {
  constructor(message, context) {
    super(message);
    this.context = context;
    this.timestamp = new Date().toISOString();
  }
}

async function createTodoWithErrorHandling(issue, label) {
  try {
    // バリデーション
    validateInput(issue, label);
    
    // API 呼び出し
    const task = await createDetailedTodo(issue, label);
    
    // 成功ログ
    await logSuccess(issue, task);
    
    return task;
    
  } catch (error) {
    // エラーログ
    await logError(error, { issue, label });
    
    // フォールバック処理
    await createFallbackTodo(issue, label);
    
    throw new TodoAutomationError(
      `Failed to create todo: ${error.message}`,
      { issue, label, originalError: error }
    );
  }
}

function validateInput(issue, label) {
  if (!issue || !issue.title) {
    throw new Error('Invalid issue: missing title');
  }
  
  if (!label || !label.name) {
    throw new Error('Invalid label: missing name');
  }
  
  if (issue.state === 'closed') {
    throw new Error('Cannot create todo for closed issue');
  }
}

Obsidian 連携によるログ管理

async function logToObsidian(logData) {
  const fs = require('fs').promises;
  const path = require('path');
  
  const logEntry = {
    timestamp: new Date().toISOString(),
    type: logData.type,
    issue: {
      number: logData.issue.number,
      title: logData.issue.title,
      url: logData.issue.html_url
    },
    todo: {
      id: logData.todo?.id,
      content: logData.todo?.content
    },
    error: logData.error
  };
  
  const logFile = path.join(process.env.OBSIDIAN_VAULT_PATH, 'Logs', 'todo-automation.md');
  const logContent = `\n## ${logEntry.timestamp}\n\`\`\`json\n${JSON.stringify(logEntry, null, 2)}\n\`\`\`\n`;
  
  await fs.appendFile(logFile, logContent);
}