Skip to main content
タスクを開始する

一般的な開発タスク

概要

本ドキュメントでは、Qoder CLI を使用して日常の開発タスクを処理するための一般的なプラクティスをまとめています。見慣れないコードの探索、バグ修正、リファクタリングから、テストの作成、コミット、レビューまでを網羅しています。各カテゴリには、そのまま使用できるプロンプトの例を示しており、ご自身のプロジェクトに合わせて調整できます。 すべての例はインタラクティブモードで実行されます。起動方法については、タスクの実行 を参照してください。

コードの探索と理解

見慣れないコードベースに直面した場合は、まず Qoder に全体像の把握を依頼します。
Help me outline the overall architecture and main modules of this project.
Where is this feature implemented? Which files are involved?
Starting from the entry point, explain clearly how a single request is processed.
Where is this function called from?
Qoder は自律的にコードを検索し、関連ファイルを読み取って、ファイルの場所を含めた説明を提示します。その回答に沿ってさらに質問を重ね、理解を深めていくことができます。

バグの修正

現象を説明し、Qoder に問題の特定と修正を依頼します。
Why did this test fail? Help me fix it
Run npm test, find the cause of the error and fix it
This API occasionally throws errors under concurrency, help me investigate
確実なアプローチとして、まず Qoder に問題を再現させ、原因を説明させてから修正作業に入らせます。影響範囲が大きい問題の場合は、Plan を使用して事前にアプローチを確認することをお勧めします。詳細は Plan による事前計画と実行 を参照してください。

リファクタリング

リファクタリングは複数のファイルにまたがる場合が多いため、目標と制約を明確に説明します。
Extract the date processing functions in utils into a standalone module and update all references
Unify error handling across this directory while maintaining the same external behavior
Refactor these callbacks to use async/await, taking care not to alter the logic
リファクタリングの前後には、テストとコードレビューを組み合わせて動作が変わっていないことを確認することをお勧めします。詳細は コード変更の確認とレビュー を参照してください。範囲の広いリファクタリングには、Plan を使用した事前計画が適しています。

機能の実装

要件に基づいて Qoder にコーディングを依頼します。
Implement an Express middleware for request rate limiting
Complete the corresponding client methods based on this API documentation
Add form validation and error messages to this page
Qoder はマルチモーダル入力をサポートしています。デザインモックアップやスクリーンショットを添付し、それに基づいてコードを生成させることができます。

テストの作成と実行

Add unit tests to this module, covering main branches
Write a regression test for the recent changes
Run tests and fix failing cases
コード作成後に Qoder が自律的にテストを実行するようにすることで、「実装・検証・修正」のサイクルを確立できます。すべてのテストがパスするまで修正を継続させたい場合は、Goal を使用します。詳細は Goal による目標の継続的達成 を参照してください。

コミットと PR

Generate a commit message for these changes
Split related changes into semantically clear commits
Summarize the changes in this branch relative to main and write a PR description
Git 操作が伴う場合、Qoder は実行前に権限設定に基づいて確認を求めます。権限制御の詳細は 権限 を参照してください。

コードレビュー

コミット前に変更内容をレビューします。
Review my current changes and identify potential issues
Compare with the main branch and review this feature branch
また、/review を直接使用してレビュー範囲を選択することもできます。詳細は コード変更の確認とレビュー を参照してください。

ヒント

  • 目標と制約を明確に説明する: 何を求めているか、何を変更したくないかを説明することで、結果の質が大幅に向上します。
  • 一度に一つのことに集中する: 複雑なタスクを複数のステップに分割する方が、すべての要件を一度に説明するよりも制御しやすくなります。
  • プロジェクト指示を有効活用する: プロジェクトの規約を AGENTS.md に記述しておくと、Qoder が各セッションでそれを遵守します。詳細は メモリ を参照してください。
  • 大規模コードベース: 大規模リポジトリやモノレポ向けのプラクティスについては、大規模コードベースのベストプラクティス を参照してください。
Qoder CLI を使用する