AgentSkillsCN

task-starter

具备在 Web 开发项目或任务启动时，快速生成所需文档集的能力。 适用场景如下： (1) 当用户提出“我想开始一个新项目”“我想启动一项任务”“我想搭建一个项目环境”的请求时； (2) 当用户明确执行“/task-starter”命令时； (3) 在新功能开发、代码重构、Bug 修复等任务中，当需要制定计划并完善相关文档时； (4) 当用户提出“请帮我规划文档结构”“请为项目搭建基本框架”的请求时； (5) 当用户提出“请创建用于任务管理的文件夹”“请做好开发前的准备工作”的请求时； (6) 当用户咨询“我想整理 TODO 列表”“我想制定一份工作计划”时； (7) 当用户提出“我想要一份规格说明书模板”“请帮忙进行任务拆分”的请求时。

SKILL.md
--- frontmatter
name: task-starter
description: |
  Web開発プロジェクト・タスクの開始時に必要なドキュメント群を作成するスキル。
  以下の状況で使用:
  (1) ユーザーが「新しいプロジェクトを始めたい」「タスクを開始したい」「プロジェクトをセットアップして」と依頼した時
  (2) ユーザーが明示的に「/task-starter」を実行した時
  (3) 新機能開発、リファクタリング、バグ修正などのタスクで計画・ドキュメント整備が必要な時
  (4) 「ドキュメント構造を作って」「プロジェクトの骨組みを用意して」と依頼された時
  (5) 「タスク管理用のフォルダを作成して」「開発の準備をして」と依頼された時
  (6) 「TODOリストを整理したい」「作業計画を立てたい」と相談された時
  (7) 「仕様書のテンプレートが欲しい」「タスク分割を手伝って」と依頼された時

Task Starter

Web開発プロジェクト・タスクの標準ドキュメント構造を生成し、計画を支援する。

ワークフロー

Phase 1: 情報収集

  1. •

    プロジェクト基本情報を収集

    code
    AskUserQuestionツールで確認:
- プロジェクト/タスク名
- 出力先ディレクトリ
- 概要と目的
- 新規開発 or 既存コード改修
  2. •

    既存コード改修の場合、現状を分析

    • •関連ファイルをGlob/Grep/Readで調査
    • •アーキテクチャと処理フローを把握
    • •課題・改善点を特定

Phase 2: 構造生成

  1. •

    プロジェクトフォルダを作成 スキルディレクトリ内のスクリプトを実行:

    bash
    python3 ~/.claude/skills/task-starter/scripts/init_project.py "{プロジェクト名}" --path "{出力先}" --description "{概要}"

    生成される構造:

    code
    YYYYMMDD-{kebab-case-name}/
├── README.md           # 概要と目的
├── references/         # 現状分析資料
├── files/              # 参考データ・ファイル
├── specs/              # 要件・仕様書
└── todos/              # タスクドキュメント
    └── 001-{task-name}/
  2. •

    参考ファイルの有無を確認

    • •ユーザーに参考データ・ファイルがあるか質問
    • •あれば files/ にコピーまたはリンク

Phase 3: ドキュメント生成

  1. •

    references/ - 現状分析（既存コード改修時のみ）

    • •references/templates/reference-template.md をベースに作成
    • •現状のアーキテクチャ、主要コンポーネント、処理フローを記載
  2. •

    specs/ - 仕様書

    • •references/templates/spec-template.md をベースに作成
    • •要件、技術仕様、UI/UX、依存関係を記載
  3. •

    todos/ - タスク分割

    • •references/templates/todo-template.md をベースに作成
    • •1-2時間で完了する粒度に分割
    • •各タスクに連番フォルダ: 001-setup/, 002-implement-xxx/, ...
    • •依存関係を考慮した順序で配置

Phase 4: レビューと確定

  1. •

    生成結果を一覧表示

    code
    📁 YYYYMMDD-project-name/
├── 📄 README.md
├── 📁 references/
│   └── 📄 current-state.md
├── 📁 files/
├── 📁 specs/
│   └── 📄 feature-spec.md
└── 📁 todos/
    ├── 📁 001-setup/
    │   └── 📄 README.md
    └── 📁 002-implement/
        └── 📄 README.md
  2. •

    ユーザーレビューを依頼

    • •構造と内容を確認してもらう
    • •フィードバックに基づき修正
  3. •

    承認後、完了メッセージを表示

TODOタスク分割ガイドライン

粒度の基準

  • •目安: 1-2時間で完了
  • •明確なゴール: 完了条件が明確
  • •独立性: 他タスクへの依存を最小化しつつ、同時対応すべき内容は1つのタスクに内包

Web開発での典型的な分割パターン

フロントエンド機能追加:

  1. •001-design-component - コンポーネント設計
  2. •002-implement-ui - UI実装
  3. •003-add-state-management - 状態管理追加
  4. •004-integrate-api - API連携
  5. •005-add-tests - テスト追加

API開発:

  1. •001-design-api - API設計
  2. •002-implement-endpoint - エンドポイント実装
  3. •003-add-validation - バリデーション追加
  4. •004-add-error-handling - エラーハンドリング
  5. •005-add-tests - テスト追加

リファクタリング:

  1. •001-analyze-current - 現状分析
  2. •002-design-new-structure - 新構造設計
  3. •003-extract-xxx - 抽出・分離
  4. •004-update-references - 参照更新
  5. •005-verify-behavior - 動作確認

実装スタイル

自由度: Medium

  • •テンプレートは固定だが、内容はプロジェクトに応じてカスタマイズ
  • •フォルダ構造は標準化、ドキュメント内容は柔軟に対応

ユーザーインタラクション

  • •Phase 1: 必須（プロジェクト情報収集）
  • •Phase 4: 必須（レビューと承認）
  • •途中キャンセル: 生成途中のファイルは削除またはユーザーに確認

エラーハンドリング

エラー対応
フォルダが既に存在エラーメッセージを表示し、別名を提案
権限不足でファイル作成不可エラーを報告し、別の出力先を提案
情報収集中にキャンセル確認後、生成済みファイルを削除するか選択させる
Python 3が未インストール手動でフォルダ構造を作成する代替手順を案内

前提条件

  • •Python 3.x（init_project.pyの実行に必要）
  • •出力先ディレクトリへの書き込み権限

リソース

scripts/

  • •init_project.py - プロジェクトフォルダ構造を生成（Python 3必須）

references/templates/

  • •spec-template.md - 仕様書テンプレート
  • •todo-template.md - TODOタスクテンプレート
  • •reference-template.md - 現状分析テンプレート