Skip to content

feat(commands): add task management commands#23

Open
nanasess wants to merge 1 commit into
mainfrom
feature/task-commands
Open

feat(commands): add task management commands#23
nanasess wants to merge 1 commit into
mainfrom
feature/task-commands

Conversation

@nanasess
Copy link
Copy Markdown
Owner

Summary

  • タスクコマンドの作成・進捗更新・アーカイブ機能を追加
  • .claude/commands/active/ ディレクトリでスラッシュコマンドとして直接実行可能なタスク管理を実現
  • /clear 後もコンテキストを保持し、フェーズごとの作業再開が可能

Changes

新規コマンド

  1. /create-task-command - タスクコマンドの作成

    • 会話内容から実装計画を抽出し、スラッシュコマンドとして保存
    • $ARGUMENTS による分岐処理でフェーズごとの作業再開をサポート
    • 自動ファイル名生成(Issue対応、機能開発、バグ修正)
  2. /update-task-progress - 進捗更新

    • 会話内容、git diff、テスト結果から完了状況を自動判定
    • チェックボックスと進捗テーブルを自動更新
    • アーカイブ機能への連携
  3. /archive-task-command - タスクのアーカイブ

    • 完了したタスクを archive/ ディレクトリに移動
    • 年月プレフィックス付きで保存
    • アーカイブ後も参照可能

ディレクトリ構造

.claude/commands/
├── active/      # 進行中のタスク
├── archive/     # 完了したタスク
└── templates/   # 再利用可能なテンプレート

Test plan

  • /create-task-command でタスクコマンドを作成できることを確認
  • 作成されたコマンドが /active:<name> で実行可能であることを確認
  • /update-task-progress で進捗が更新されることを確認
  • /archive-task-command でタスクがアーカイブされることを確認

🤖 Generated with Claude Code

Add three new command documentation files for task lifecycle management:

- archive-task-command.md: Move completed tasks from active to archive
- create-task-command.md: Create new executable task commands with
  phase-based workflow support
- update-task-progress.md: Update task progress with auto-detection
  from git changes and conversation context

These commands enable persistent task tracking across /clear
boundaries with structured progress management.
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @nanasess, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

このプルリクエストは、開発ワークフローを効率化するための包括的なタスク管理システムを導入します。これにより、ユーザーは会話から直接タスクコマンドを作成し、その進捗を自動的に更新し、完了したタスクを整理してアーカイブできるようになります。このシステムは、コンテキストを維持し、フェーズごとの作業再開を容易にすることで、開発プロセスをよりスムーズにすることを目的としています。

Highlights

  • タスク管理コマンドの導入: タスクの作成、進捗更新、アーカイブを行う3つの新しいスラッシュコマンドが追加されました。
  • コンテキスト保持と実行可能性: /clear 後もコンテキストを保持し、.claude/commands/active/ ディレクトリ内のタスクがスラッシュコマンドとして直接実行可能になります。
  • 自動進捗更新: 会話内容、git diff、テスト結果に基づいてタスクの完了状況を自動判定し、進捗を更新する機能が実装されました。
  • タスクのアーカイブ機能: 完了したタスクを日付プレフィックス付きで archive/ ディレクトリに移動し、整理・参照可能にする機能が追加されました。
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

このプルリクエストでは、タスク管理のための新しいコマンド (/create-task-command, /update-task-progress, /archive-task-command) が追加されました。これにより、スラッシュコマンドとして実行可能なタスクファイルを作成し、進捗管理からアーカイブまで一貫して行えるようになります。
全体的にドキュメントは非常に詳細で分かりやすいです。
ただし、/update-task-progress コマンドの設計に関して2点ほど改善提案があります。1つは、/archive-task-command との機能重複について、もう1つは引数なしの場合のファイル選択ロジックの明確化についてです。詳細は各コメントをご確認ください。

Comment on lines +17 to +18
- 最も新しく更新されたファイルを使用
- 複数見つかった場合: 一覧表示して選択を促す
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

ここのファイル選択ロジックが少し曖昧です。「最も新しく更新されたファイルを使用」と「複数見つかった場合: 一覧表示して選択を促す」は、状況によっては矛盾する可能性があります。

例えば、既存の /load-plan コマンドのように「複数見つかった場合、最新のファイルを使用し、他のファイルも一覧表示する」といった、より明確な動作を記述するのはどうでしょうか。あるいは、常にユーザーに選択を促す方針も考えられます。

どちらの挙動が望ましいか意図を明確にすることで、ドキュメントの価値がさらに高まります。

Comment on lines +114 to +126
## アーカイブ機能

タスクが完全に完了したら、`archive` 引数を使用して `archive/` ディレクトリに移動できます:

```bash
/update-task-progress archive issue-572-implement.md
```

これにより:
- ファイルが `.claude/commands/active/` から `.claude/commands/archive/` に移動
- ファイル名に日付プレフィックスが追加(例: `2026-01-issue-572-implement.md`)
- アーカイブ後も `/archive:2026-01-issue-572-implement` で参照可能

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

このコマンドにアーカイブ機能が含まれていますが、archive-task-command という専用のコマンドも同時に追加されています。機能が重複していると、どちらを使うべきか混乱を招く可能性があります。

責務の分離の観点から、アーカイブ機能は archive-task-command に集約し、update-task-progress は進捗更新に専念させるのが良いでしょう。
例えば、このコマンドでタスクが100%完了した際に、次のアクションとして /archive-task-command の実行を提案する形が考えられます。

これにより、各コマンドの役割が明確になり、メンテナンス性も向上します。

@nanasess
Copy link
Copy Markdown
Owner Author

  • リモートブランチ同期
  • 新規ブランチ作成
  • タスクごとにコミットする
    など、一連の開発の流れもメタコマンドで指示できると良さそう

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant