From dcb6356ebba8fa34f47c3910722c27bd1531e20b Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 28 Mar 2026 01:10:41 +0000 Subject: [PATCH] docs: sync and translate English doc changes to Japanese --- docs/jp/cli/configuration/hooks-guide.mdx | 149 +++++----- .../guides/power-user/memory-management.mdx | 247 ++++++----------- docs/jp/guides/power-user/prompt-crafting.mdx | 257 ++++++++---------- docs/jp/guides/power-user/setup-checklist.mdx | 214 +++++++-------- 4 files changed, 364 insertions(+), 503 deletions(-) diff --git a/docs/jp/cli/configuration/hooks-guide.mdx b/docs/jp/cli/configuration/hooks-guide.mdx index 05a5c6a..2660c0b 100644 --- a/docs/jp/cli/configuration/hooks-guide.mdx +++ b/docs/jp/cli/configuration/hooks-guide.mdx @@ -1,59 +1,59 @@ --- -title: "フック" -description: "Learn how to customize and extend Droid's behavior by registering shell commands" +title: "Hooks" +description: Droidの動作をカスタマイズ・拡張するためのシェルコマンド登録方法を学ぶ keywords: ['hooks', 'lifecycle', 'automation', 'shell commands', 'events', 'triggers', 'customize', 'extend'] --- -Droidフックは、Droidのライフサイクルの様々な段階で実行されるユーザー定義のシェルコマンドです。フックは、Droidの動作を決定論的に制御し、Droidが選択的に実行するのではなく、特定のアクションが常に実行されることを保証します。 +Droidフックは、Droidのライフサイクルの様々な段階で実行されるユーザー定義のシェルコマンドです。フックはDroidの動作に対する決定論的な制御を提供し、Droidが選択的に実行するのではなく、特定のアクションが常に実行されることを保証します。 - For reference documentation on hooks, see [Hooks reference](/reference/hooks-reference). - Explore the [hook cookbooks](/guides/hooks/auto-formatting). + フックのリファレンスドキュメントについては、[Hooks reference](/jp/reference/hooks-reference)を参照してください。 + [hook cookbooks](/jp/guides/hooks/auto-formatting)も参照してください。 フックの使用例には以下があります： -* **通知**: Droidがユーザーの入力や実行許可を待機している際の通知方法をカスタマイズします。 -* **自動フォーマット**: ファイル編集後に.tsファイルに対して`prettier`を、.goファイルに対して`gofmt`を実行します。 -* **ログ記録**: コンプライアンスやデバッグのために、実行されたすべてのコマンドを追跡・カウントします。 -* **フィードバック**: Droidがコードベースの規約に従わないコードを生成した際に、自動フィードバックを提供します。 +* **通知**: Droidがあなたの入力や実行許可を待っているときの通知方法をカスタマイズします。 +* **自動フォーマット**: ファイル編集後に.tsファイルに`prettier`、.goファイルに`gofmt`などを実行します。 +* **ログ記録**: コンプライアンスやデバッグのために、実行されたすべてのコマンドを追跡・集計します。 +* **フィードバック**: Droidがコードベース規約に従わないコードを生成した際に自動フィードバックを提供します。 * **カスタム権限**: 本番ファイルや機密ディレクトリへの変更をブロックします。 -これらのルールをプロンプト指示ではなくフックとしてエンコードすることで、提案を実行される度に毎回動作するアプリレベルのコードに変換できます。 +これらのルールをプロンプト指示としてではなくフックとして記述することで、提案をアプリレベルのコードに変換し、期待されるタイミングで毎回実行されるようになります。 - You must consider the security implication of hooks as you add them, because hooks run automatically during Droid's execution with your current environment's credentials. - For example, malicious hooks code can exfiltrate your data. Always review your hooks implementation before registering them. + フックはDroidの実行中にあなたの現在の環境の認証情報で自動的に実行されるため、フックを追加する際はセキュリティへの影響を考慮する必要があります。 + たとえば、悪意のあるフックコードはあなたのデータを漏洩させる可能性があります。フックを登録する前に、必ずフックの実装を確認してください。 - For full security best practices, see [Security Considerations](/reference/hooks-reference#security-considerations) in the hooks reference documentation. + 完全なセキュリティのベストプラクティスについては、フックリファレンスドキュメントの[Security Considerations](/jp/reference/hooks-reference#security-considerations)を参照してください。 - **Important**: Always use **absolute paths** when referencing scripts in your hook commands, not relative paths. - Hooks execute from Droid's current working directory, which may not be your project root. - Use `$FACTORY_PROJECT_DIR` for project-relative scripts (e.g., `"$FACTORY_PROJECT_DIR"/.factory/hooks/script.sh`) - or full paths for global scripts (e.g., `/usr/local/bin/my-hook.sh` or `~/.factory/hooks/script.sh`). + **重要**: フックコマンドでスクリプトを参照する際は、相対パスではなく**絶対パス**を使用してください。 + フックはDroidの現在の作業ディレクトリから実行され、これがプロジェクトルートではない場合があります。 + プロジェクト相対のスクリプトには`$FACTORY_PROJECT_DIR`を使用し（例：`"$FACTORY_PROJECT_DIR"/.factory/hooks/script.sh`）、 + グローバルスクリプトにはフルパスを使用してください（例：`/usr/local/bin/my-hook.sh`や`~/.factory/hooks/script.sh`）。 ## フックイベント概要 -Droidは、ワークフローの異なる段階で実行される複数のフックイベントを提供します： +Droidはワークフローの異なる段階で実行される複数のフックイベントを提供します： * **PreToolUse**: ツール呼び出し前に実行（ブロック可能） * **PostToolUse**: ツール呼び出し完了後に実行 * **UserPromptSubmit**: ユーザーがプロンプトを送信し、Droidが処理する前に実行 -* **Notification**: Droid が通知を送信する際に実行 -* **Stop**: Droidが応答を終了する際に実行 -* **SubagentStop**: サブDroidタスクが完了する際に実行 -* **PreCompact**: Droidがコンパクト操作を実行しようとする前に実行 -* **SessionStart**: Droidが新しいセッションを開始するか、既存のセッションを再開する際に実行 -* **SessionEnd**: Droidセッションが終了する際に実行 +* **Notification**: Droidが通知を送信するときに実行 +* **Stop**: Droidが応答を完了したときに実行 +* **SubagentStop**: サブdroidタスクが完了したときに実行 +* **PreCompact**: Droidがコンパクト操作を実行する前に実行 +* **SessionStart**: Droidが新しいセッションを開始するか既存のセッションを再開するときに実行 +* **SessionEnd**: Droidセッションが終了するときに実行 -各イベントは異なるデータを受信し、Droidの動作を異なる方法で制御できます。 +各イベントは異なるデータを受信し、異なる方法でDroidの動作を制御できます。 ## クイックスタート -このクイックスタートでは、Droidが実行するシェルコマンドをログ記録するフックを追加します。 +このクイックスタートでは、Droidが実行するシェルコマンドをログに記録するフックを追加します。 ### 前提条件 @@ -61,37 +61,31 @@ Droidは、ワークフローの異なる段階で実行される複数のフッ ### ステップ1: フック設定を開く -`/hooks` [slash command](/cli/configuration/custom-slash-commands)を実行し、`PreToolUse`フックイベントを選択します。 +`/hooks` [スラッシュコマンド](/jp/cli/configuration/custom-slash-commands)を実行し、`PreToolUse`フックイベントを選択します。 -`PreToolUse`フックはツール呼び出し前に実行され、異なる対応についてDroidにフィードバックを提供しながらツール呼び出しをブロックできます。 +`PreToolUse`フックはツール呼び出し前に実行され、Droidに異なる処理を指示するフィードバックを提供しながらそれらをブロックできます。 ### ステップ2: マッチャーを追加 -`+ Add new matcher…`を選択して、Executeツール呼び出しのみでフックを実行します。 +`+ Add new matcher…`を選択して、Executeツール呼び出しにのみフックを実行するようにします。 マッチャーに`Execute`と入力します。 -You can use `*` to match all tools. +すべてのツールにマッチさせるには`*`を使用できます。 ### ステップ3: フックを追加 -`+ Add new hook…`を選択し、以下のコマンドを入力します： - -```bash +`+ Add new hook…`を選択し、このコマンドを入力します：```bash jq -r '.tool_input.command' >> ~/.factory/bash-command-log.txt -``` - -### ステップ4: 設定を保存 +```### ステップ 4: 設定を保存する -ストレージの場所については、ホームディレクトリにログ記録しているため`User settings`を選択します。これにより、フックは現在のプロジェクトだけでなく、すべてのプロジェクトに適用されます。 +保存場所として、ホームディレクトリにログを記録するため `User settings` を選択します。このフックは現在のプロジェクトだけでなく、すべてのプロジェクトに適用されます。 -その後、REPLに戻るまでEscを押します。フックが登録されました！ +次に、REPLに戻るまでEscキーを押します。これでフックが登録されました！ -### ステップ5: フックを確認 +### ステップ 5: フックを確認する -再度`/hooks`を実行するか、`~/.factory/settings.json`をチェックして設定を確認します： - -```json +再度 `/hooks` を実行するか、`~/.factory/settings.json` を確認して設定を見てください：```json { "hooks": { "PreToolUse": [ @@ -107,29 +101,17 @@ jq -r '.tool_input.command' >> ~/.factory/bash-command-log.txt ] } } -``` - -### ステップ6: フックをテスト +```### ステップ6: フックをテストする -Droidに`ls`のような簡単なコマンドを実行するよう依頼し、ログファイルを確認します： - -```bash +Droidに`ls`のような簡単なコマンドを実行してもらい、ログファイルを確認してください：```bash cat ~/.factory/bash-command-log.txt -``` - -以下のようなエントリが表示されるはずです： - -``` +```以下のようなエントリが表示されるはずです：``` ls -``` +```## より多くの例 -## その他の例 +### コード整形フック -### コードフォーマットフック - -編集後にTypeScriptファイルを自動フォーマット： - -```json +編集後にTypeScriptファイルを自動的に整形:```json { "hooks": { "PostToolUse": [ @@ -145,13 +127,9 @@ ls ] } } -``` +```### Markdown フォーマットフック -### Markdownフォーマットフック - -markdownファイルの言語タグの欠落やフォーマットの問題を自動修正： - -```json +markdownファイルの言語タグの不足やフォーマットの問題を自動的に修正します：```json { "hooks": { "PostToolUse": [ @@ -167,11 +145,7 @@ markdownファイルの言語タグの欠落やフォーマットの問題を自 ] } } -``` - -以下の内容で`.factory/hooks/markdown_formatter.py`を作成： - -```python +````.factory/hooks/markdown_formatter.py` をこの内容で作成してください：```python #!/usr/bin/env python3 """ Markdown formatter for Droid output. @@ -225,21 +199,21 @@ def format_markdown(content): return f"{indent}```{lang}\n{body}{closing}\n" return match.group(0) - fence_pattern = r'(?ms)^([ \t]{0,3})```([^\n]*)\n(.*?)(\n\1```)\s*$' + fence_pattern = r'(?ms)^([ \t]{0,3})```([^\r\n]*)\r?\n(.*?)\r?\n\1```[ \t]*$'```([^\n]*)\n(.*?)(\n\1```)\s*$' content = re.sub(fence_pattern, add_lang_to_fence, content) - # Fix excessive blank lines (only outside code fences) + # 過度な空行を修正（コードフェンス外のみ） content = re.sub(r'\n{3,}', '\n\n', content) return content.rstrip() + '\n' -# Main execution +# メイン実行 try: input_data = json.load(sys.stdin) file_path = input_data.get('tool_input', {}).get('file_path', '') if not file_path.endswith(('.md', '.mdx')): - sys.exit(0) # Not a markdown file + sys.exit(0) # Markdownファイルではない if os.path.exists(file_path): with open(file_path, 'r', encoding='utf-8') as f: @@ -250,18 +224,17 @@ try: if formatted != content: with open(file_path, 'w', encoding='utf-8') as f: f.write(formatted) - print(f"✓ Fixed markdown formatting in {file_path}") + print(f"✓ {file_path}のMarkdownフォーマットを修正しました") except Exception as e: - print(f"Error formatting markdown: {e}", file=sys.stderr) - sys.exit(1) -``` + print(f"Markdownフォーマット中にエラーが発生しました: {e}", file=sys.stderr) + sys.exit(1)``` Make the script executable: -```bash +``````bash chmod +x .factory/hooks/markdown_formatter.py -``` +`````` This hook automatically: @@ -274,7 +247,7 @@ This hook automatically: Get desktop notifications when Droid needs input: -```json +``````json { "hooks": { "Notification": [ @@ -290,13 +263,13 @@ Get desktop notifications when Droid needs input: ] } } -``` +`````` ### File Protection Hook Block edits to sensitive files: -```json +``````json { "hooks": { "PreToolUse": [ @@ -314,8 +287,8 @@ Block edits to sensitive files: } ``` -## 詳細情報 +## 詳細を学ぶ -* フックのリファレンスドキュメントについては、[Hooks reference](/reference/hooks-reference)を参照してください。 -* 包括的なセキュリティのベストプラクティスと安全ガイドラインについては、フックリファレンスドキュメントの[Security Considerations](/reference/hooks-reference#security-considerations)を参照してください。 -* トラブルシューティング手順とデバッグテクニックについては、フックリファレンスドキュメントの[Debugging](/reference/hooks-reference#debugging)を参照してください。 \ No newline at end of file +* フックのリファレンスドキュメントについては、[フックリファレンス](/jp/reference/hooks-reference)をご覧ください。 +* 包括的なセキュリティのベストプラクティスと安全ガイドラインについては、フックリファレンスドキュメントの[セキュリティに関する考慮事項](/jp/reference/hooks-reference#security-considerations)をご覧ください。 +* トラブルシューティング手順とデバッグ技術については、フックリファレンスドキュメントの[デバッグ](/jp/reference/hooks-reference#debugging)をご覧ください。 \ No newline at end of file diff --git a/docs/jp/guides/power-user/memory-management.mdx b/docs/jp/guides/power-user/memory-management.mdx index a92b937..f3e4cb8 100644 --- a/docs/jp/guides/power-user/memory-management.mdx +++ b/docs/jp/guides/power-user/memory-management.mdx @@ -1,22 +1,20 @@ --- -title: "メモリとコンテキスト管理" -description: Build persistent memory so Droid remembers your preferences, decisions, and project history across sessions. +title: Memory and Context Management +description: Droidがセッション間であなたの設定、決定、プロジェクト履歴を記憶する永続的なメモリを構築します。 keywords: ['memory', 'context', 'preferences', 'persistent', 'sessions', 'history', 'memories'] --- -Droidはセッション間で組み込みのメモリを持ちませんが、markdownファイル、AGENTS.mdの参照、およびフックを使用して強力なメモリシステムを作成できます。このガイドでは、永続化され成長するメモリの構築方法を説明します。 +Droidにはセッション間でのビルトインメモリはありませんが、markdownファイル、AGENTS.mdの参照、フックを使って強力なメモリシステムを作ることができます。このガイドでは、永続化して成長するメモリの構築方法を説明します。 - **Works with Factory App:** These memory patterns work identically in both CLI and [Factory App](/web/getting-started/overview)—just ensure your working directory is set to your repository root. + **Factory Appで動作:** これらのメモリパターンはCLIと[Factory App](/jp/web/getting-started/overview)の両方で同様に動作します—作業ディレクトリがリポジトリのルートに設定されていることを確認してください。 --- ## メモリシステムアーキテクチャ -メモリシステムは3つの層で構成されます： - -``` +メモリシステムは3つのレイヤーで構成されています：``` ┌─────────────────────────────────────────────────────┐ │ AGENTS.md │ │ (References and orchestrates memory) │ @@ -33,19 +31,15 @@ Droidはセッション間で組み込みのメモリを持ちませんが、mar │ • Style │ │ • History │ │ • Patterns │ │ • Tools │ │ • Context │ │ • Guidelines │ └─────────────────┘ └─────────────┘ └─────────────────┘ -``` - ---- - -## 個人メモリの設定 +```--- -個人メモリはすべてのプロジェクトで共有されます。 +## パーソナルメモリの設定 -### ステップ1：メモリファイルの作成 +パーソナルメモリは、すべてのプロジェクト間で共有されます。 -`~/.factory/memories.md`を作成します： +### ステップ1: メモリファイルの作成 -```markdown +`~/.factory/memories.md`を作成します：```markdown # My Development Memory ## Code Style Preferences @@ -80,29 +74,21 @@ Droidはセッション間で組み込みのメモリを持ちませんが、mar - [2024-01] Switched from Create React App to Vite - [2024-02] Adopted Tailwind CSS as default styling - [2024-03] Using Supabase for personal projects -``` - -### ステップ2：AGENTS.mdで参照 +```### ステップ2: AGENTS.mdで参照 -`~/.factory/AGENTS.md`またはプロジェクトの`AGENTS.md`に追加します： - -```markdown +`~/.factory/AGENTS.md` または プロジェクトの `AGENTS.md` に追加:```markdown ## Personal Preferences My coding preferences and tool choices are documented in `~/.factory/memories.md`. Refer to this file when making decisions about code style, architecture, or tooling. -``` - ---- +```--- -## プロジェクトメモリの設定 +## プロジェクトメモリーの設定 -プロジェクトメモリは、コードベース固有の決定とコンテキストを記録します。 +プロジェクトメモリーは、コードベース固有の決定事項とコンテキストを記録します。 -### ステップ1：プロジェクトメモリの作成 +### ステップ1: プロジェクトメモリーの作成 -プロジェクトルートに`.factory/memories.md`を作成します： - -```markdown +プロジェクトルートに `.factory/memories.md` を作成します：```markdown # Project Memory ## Project Context @@ -152,91 +138,68 @@ Refer to this file when making decisions about code style, architecture, or tool - All PRs need at least one approval - Deploy to staging on merge to `develop` - Deploy to production on merge to `main` -``` - -### ステップ2：プロジェクトAGENTS.mdで参照 +```### ステップ2: プロジェクトのAGENTS.mdで参照 -プロジェクトの`AGENTS.md`を更新します： - -```markdown +プロジェクトの`AGENTS.md`を更新してください：```markdown ## Project Memory Architecture decisions, domain knowledge, and project history are documented in `.factory/memories.md`. Always check this file before making significant architectural or design decisions. -``` - ---- +```--- -## メモリカテゴリ +## メモリーカテゴリ -メモリを有用なカテゴリに整理します： +メモリーを便利なカテゴリに整理しましょう： ### 設定（個人） -あなたの好みと作業方法： - -```markdown +あなたの好みと作業方法：```markdown ## Preferences - Code style choices - Tool preferences - Communication style - Learning style -``` - -### 決定（プロジェクト） -何が決定され、その理由： - -```markdown +```### 決定事項（プロジェクト） +何が決定され、その理由：```markdown ## Decisions - Architecture choices with reasoning - Library selections with trade-offs - Design patterns adopted - Standards agreed upon -``` +```I don't see any actual content to translate in your message. You've provided the translation rules but no source text to work with. -### コンテキスト（プロジェクト） -背景情報： - -```markdown +Could you please provide the English technical documentation (MDX/Markdown) that you'd like me to translate to Japanese?```markdown ## Context - Business domain knowledge - Key entities and relationships - External integrations - Performance requirements -``` - -### 履歴（両方） -いつ何が起こったか： - -```markdown +```### 履歴（両方） +いつ何が起こったか：```markdown ## History - Major refactors completed - Migrations performed - Issues resolved - Lessons learned -``` +```--- ---- - -## 自動メモリ取得 +## 自動メモリキャプチャ -作業中にメモリを取得するのに役立つフックを作成します。 +作業中にメモリをキャプチャするのに役立つフックを作成します。 -### 「これを記憶」フック +### 「これを覚える」フック 「remember this:」の後にコンテンツを続けると、自動的にメモリに追加されます。 -メモリキャプチャは**特殊文字**または**フレーズ**のいずれかでトリガーできます。好みに基づいて選択してください： +**特殊文字**または**フレーズ**のいずれかでメモリキャプチャをトリガーできます。お好みに応じて選択してください： - - Trigger with `#` at the start of your message for quick capture. + + クイックキャプチャのためにメッセージの先頭に`#`を使用してトリガーします。 - **Usage:** - - "#we use the repository pattern" - - "##I prefer early returns" (double `##` for personal) + **使用方法:** + - "#リポジトリパターンを使用する" + - "##早期リターンを好む"（個人用は`##`を2つ） - Create `~/.factory/hooks/memory-capture.py`: - - ```python + `~/.factory/hooks/memory-capture.py`を作成します：```python #!/usr/bin/env python3 """Captures messages starting with # and appends to memories.md""" import json, sys, os @@ -274,19 +237,16 @@ Always check this file before making significant architectural or design decisio if __name__ == '__main__': main() - ``` - + ``` - - Trigger with phrases like "remember this:", "note:", etc. + + 「これを覚えて：」、「メモ：」などのフレーズでトリガーします。 - **Usage:** + **使用方法:** - "Remember this: we use the repository pattern" - "Note: auth tokens expire after 24 hours" - Create `~/.factory/hooks/memory-capture.py`: - - ```python + `~/.factory/hooks/memory-capture.py`を作成します：```python #!/usr/bin/env python3 """Captures 'remember this:' statements and appends to memories.md""" import json, sys, os @@ -327,19 +287,14 @@ Always check this file before making significant architectural or design decisio if __name__ == '__main__': main() - ``` - - - -実行可能にし、フックを設定します： - -```bash -chmod +x ~/.factory/hooks/memory-capture.py + ``````bash +chmod +x .git/hooks/pre-commit +git config core.hooksPath .git/hooks ``` -`/hooks`を使用してフック設定に追加します： - -```json +実行可能にし、フックを設定してください：```bash +chmod +x ~/.factory/hooks/memory-capture.py +```フックス設定に `/hooks` 経由で追加してください：```json { "hooks": { "UserPromptSubmit": [ @@ -355,27 +310,23 @@ chmod +x ~/.factory/hooks/memory-capture.py ] } } -``` - -**#プレフィックス使用：** -- "#we decided to use Zustand for state management" -- "##I prefer early returns" （ダブル`##`は個人用に保存） - -**フレーズトリガー使用：** -- "Remember this: we decided to use Zustand for state management" -- "Note: the auth module uses JWT with 24-hour expiration" +```**# プレフィックス付き:** +- "#状態管理にはZustandを使用することにした" +- "##早期リターンを好む" (ダブル `##` は個人用に保存) -### 代替案：メモリキャプチャスキル +**フレーズトリガー付き:** +- "これを覚えておいて: 状態管理にはZustandを使用することにした" +- "注意: 認証モジュールは24時間の有効期限付きJWTを使用" -フックの代わりに、何かを記憶するように依頼したときにDroidが呼び出す[skill](/cli/configuration/skills)を使用できます。これにより、カテゴリ化をよりインタラクティブに制御できます。 +### 代替案: メモリキャプチャスキル -### 代替案：カスタムスラッシュコマンド +フックの代わりに、何かを覚えるように依頼した時にDroidが呼び出す[スキル](/jp/cli/configuration/skills)を使用できます。これにより、カテゴリ化をより対話的に制御できます。 -手動での素早い取得には、[custom slash command](/cli/configuration/custom-slash-commands)を作成します： +### 代替案: カスタムスラッシュコマンド -`~/.factory/commands/remember.md`を作成： +手動での素早いキャプチャのために、[カスタムスラッシュコマンド](/jp/cli/configuration/custom-slash-commands)を作成します: -```markdown +`~/.factory/commands/remember.md` を作成:```markdown --- description: Save a memory to your memories file argument-hint: @@ -386,15 +337,13 @@ Add this to my memories file (~/.factory/memories.md): $ARGUMENTS Format it appropriately based on whether it's a preference, decision, or learning. Include today's date. -``` - -その後、`/remember we chose PostgreSQL for better ACID compliance`を使用してメモリをオンデマンドで取得します。 +```それから `/remember PostgreSQLをより良いACIDコンプライアンスのために選択した` を使用してオンデマンドでメモリをキャプチャします。 - **Which approach to choose?** - - **Hook** — Best for automatic capture without extra steps - - **Skill** — Best when you want Droid to help categorize and format - - **Slash Command** — Best for quick manual capture with consistent formatting + **どのアプローチを選ぶべきか？** + - **Hook** — 追加の手順なしで自動キャプチャするのに最適 + - **Skill** — Droidに分類とフォーマットを手伝わせたい場合に最適 + - **スラッシュコマンド** — 一貫したフォーマットで素早く手動キャプチャするのに最適 --- @@ -403,9 +352,7 @@ Format it appropriately based on whether it's a preference, decision, or learnin 定期的なメンテナンスでメモリを有用に保ちます。 -### 月次レビューチェックリスト - -```markdown +### 月次レビューチェックリスト```markdown ## Monthly Memory Review ### Personal Memory (~/.factory/memories.md) @@ -419,13 +366,9 @@ Format it appropriately based on whether it's a preference, decision, or learnin - [ ] Update technical debt items - [ ] Add new domain knowledge learned - [ ] Document recent major changes -``` - -### 古いメモリのアーカイブ +```### 古い記憶のアーカイブ -メモリが古くなったら、アーカイブに移動します： - -```markdown +記憶が古くなったときは、アーカイブに移動します：```markdown # memories.md ## Current Decisions @@ -441,15 +384,11 @@ Format it appropriately based on whether it's a preference, decision, or learnin **Reason for change**: Maintenance burden, security updates -``` - ---- - -## 上級：メモリ対応スキル +```--- -メモリファイルを活用するスキルを作成します： +## 上級: メモリ対応スキル -```markdown +メモリファイルを活用するスキルを作成する：```markdown --- name: context-aware-implementation description: Implement features using project memory and conventions. @@ -473,49 +412,43 @@ Before implementing any feature: - What testing requirements exist? Then implement following all discovered context. -``` - ---- +```--- ## クイックリファレンス -### ファイル場所 +### ファイルの場所 -| メモリタイプ | 場所 | スコープ | -|-------------|------|---------| +| メモリタイプ | 場所 | 範囲 | +|-------------|----------|-------| | 個人設定 | `~/.factory/memories.md` | 全プロジェクト | -| プロジェクト決定 | `.factory/memories.md` | このプロジェクト | -| チーム規約 | `.factory/rules/*.md` | このプロジェクト | +| プロジェクト決定事項 | `.factory/memories.md` | このプロジェクト | +| チーム慣例 | `.factory/rules/*.md` | このプロジェクト | ### メモリを追加するタイミング -| イベント | 記録内容 | 場所 | -|---------|-----------|-------| -| アーキテクチャ決定を行った | 決定 + 理由 | プロジェクト | -| 設定を発見した | 好み | 個人 | +| イベント | 記録すべき内容 | 場所 | +|-------|---------------|-------| +| アーキテクチャ決定を行った | 決定事項と理由 | プロジェクト | +| 設定を発見した | 自分が好む設定 | 個人 | | ドメイン知識を学んだ | ビジネスルール、エンティティ | プロジェクト | | ワークフローを変更した | 新しいツールやパターン | 個人 | -| 複雑な問題を解決した | 解決策とコンテキスト | プロジェクト | - -### メモリフォーマットテンプレート +| 複雑な問題を解決した | 解決策と文脈 | プロジェクト | -```markdown +### メモリフォーマットテンプレート```markdown ### [Date]: [Title] **Decision/Preference**: [What] **Reasoning**: [Why] **Context**: [When this applies] **Trade-offs**: [What you gave up] -``` - ---- +```--- ## 次のステップ - - Complete power user configuration + + パワーユーザー設定を完了する - - Organize team conventions + + チーム規約を整理する \ No newline at end of file diff --git a/docs/jp/guides/power-user/prompt-crafting.mdx b/docs/jp/guides/power-user/prompt-crafting.mdx index 18adbea..422005d 100644 --- a/docs/jp/guides/power-user/prompt-crafting.mdx +++ b/docs/jp/guides/power-user/prompt-crafting.mdx @@ -1,58 +1,58 @@ --- -title: "モデル別プロンプト作成" -description: Model-specific prompting techniques to get better results from Claude, GPT, and other models. +title: Prompt Crafting for Different Models +description: Claude、GPT、その他のモデルでより良い結果を得るためのモデル固有のプロンプト技法。 keywords: ['prompts', 'prompting', 'claude', 'gpt', 'opus', 'sonnet', 'techniques', 'best practices'] --- -異なるAIモデルは、それぞれ異なるプロンプトスタイルによりよく応答します。このガイドでは、モデル固有のテクニックをカバーし、すぐに使用できるプロンプト改良スキルを提供します。 +異なるAIモデルは、異なるプロンプティングスタイルによりよく応答します。このガイドでは、モデル固有のテクニックをカバーし、すぐに使えるプロンプト改善スキルを提供します。 - **Works everywhere:** These prompting techniques apply to both CLI and [Factory App](/web/getting-started/overview). + **どこでも動作:** これらのプロンプティング技法は、CLIと[Factory App](/jp/web/getting-started/overview)の両方に適用されます。 --- -## 汎用プロンプト原則 +## 汎用プロンプティング原則 -これらの原則は全てのモデルで機能します： +これらの原則は全てのモデルで機能します: - - **Weak:** "Fix the bug in auth" + + **弱い例:** "認証のバグを修正して" - **Strong:** "Fix the login timeout bug where users get logged out after 5 minutes of inactivity. The session should persist for 24 hours." + **強い例:** "5分間非アクティブ状態でユーザーがログアウトされるログインタイムアウトバグを修正してください。セッションは24時間持続するべきです。" - - **Weak:** "Add error handling" + + **弱い例:** "エラーハンドリングを追加して" - **Strong:** "This API endpoint handles payment processing. It currently crashes silently on network errors. Add error handling that logs the error, returns a user-friendly message, and triggers an alert." + **強い例:** "このAPIエンドポイントは決済処理を扱います。現在、ネットワークエラーで無音クラッシュします。エラーをログし、ユーザーフレンドリーなメッセージを返し、アラートをトリガーするエラーハンドリングを追加してください。" - - **Weak:** "Make it faster" + + **弱い例:** "より速くして" - **Strong:** "Optimize the search query. Success criteria: query time under 100ms for 10k records, no change to result accuracy, passes existing tests." + **強い例:** "検索クエリを最適化してください。成功基準: 1万件のレコードで100ms未満のクエリ時間、結果精度に変更なし、既存テストに合格。" - - **Weak:** "Refactor this code" + + **弱い例:** "このコードをリファクタリングして" - **Strong:** "Refactor this code to use the repository pattern. Constraints: don't change the public API, maintain backward compatibility, keep the same test coverage." + **強い例:** "このコードをリポジトリパターンを使用するようにリファクタリングしてください。制約: パブリックAPIを変更しない、後方互換性を維持、同じテストカバレッジを保持。" --- -## Claudeモデル（Opus、Sonnet、Haiku） +## Claudeモデル (Opus, Sonnet, Haiku) Claudeモデルは構造化された明示的な指示に優れ、特定のフォーマットパターンに特によく応答します。 ### Claudeの主要テクニック - - Claude responds exceptionally well to XML-style tags for organizing complex prompts: + + Claudeは複雑なプロンプトを整理するためのXMLスタイルのタグに非常によく応答します: ``` @@ -69,11 +69,10 @@ Claudeモデルは構造化された明示的な指示に優れ、特定のフ - Update JWT expiration accordingly - Add unit tests for the new functionality - ``` - + ``` - - When you want specific output formats, show examples: + + 特定の出力形式が必要な場合は、例を示してください： ``` @@ -85,11 +84,10 @@ Claudeモデルは構造化された明示的な指示に優れ、特定のフ - Invalid password - Account locked - Session expired - ``` - + ``` - - For complex decisions, ask Claude to think through options: + + 複雑な判断には、Claudeに選択肢を検討してもらいます： ``` Before implementing, analyze: @@ -98,19 +96,16 @@ Claudeモデルは構造化された明示的な指示に優れ、特定のフ 3. What edge cases should we consider? Then implement the better approach. - ``` - + ``` - Copy the prompt refiner skills below to `~/.factory/skills/` to use them. Learn more about skills in the [Skills documentation](/cli/configuration/skills). + 以下のプロンプトリファイナースキルを `~/.factory/skills/` にコピーして使用してください。スキルについて詳しくは[スキルドキュメント](/jp/cli/configuration/skills)をご覧ください。 -### Claudeプロンプト改良スキル +### Claude プロンプトリファイナースキル -`~/.factory/skills/prompt-refiner-claude/SKILL.md`を作成してください： - -```markdown +`~/.factory/skills/prompt-refiner-claude/SKILL.md` を作成します：```markdown --- name: prompt-refiner-claude description: Refine prompts for Claude models (Opus, Sonnet, Haiku) using Anthropic's best practices. Use when preparing complex tasks for Claude. @@ -167,53 +162,48 @@ Present the improved prompt with: "Add caching to the API" **After:** -``` - -/api/productsエンドポイントは現在、すべてのリクエストでデータベースにクエリしています。 -平均応答時間は200msです。アプリの他のキャッシュにはRedisを使用しています。 +``` +`/api/products`エンドポイントは現在、リクエストごとにデータベースにクエリを実行しています。 +平均レスポンス時間は200msです。アプリの他のキャッシュにはRedisを使用しています。 -データベース負荷を軽減するために/api/productsエンドポイントにRedisキャッシュを追加する。 +データベース負荷を軽減するため、`/api/products`エンドポイントにRedisキャッシュを追加します。 -- 5分のキャッシュTTL -- 製品が更新された時のキャッシュ無効化 -- Redisが利用できない場合のデータベースへのグレースフルフォールバック -- キャッシュヒット/ミスメトリクスログの追加 +- キャッシュTTLを5分に設定 +- 商品が更新された際のキャッシュ無効化 +- Redisが利用できない場合のデータベースへの適切なフォールバック +- キャッシュヒット/ミスメトリクスのログ記録を追加 - レスポンス形式を変更しない -- 既存の統合テストに合格する必要がある -- src/lib/redis.tsの既存のRedis接続を使用する - -``` -``` - ---- +- 既存の統合テストを通過する必要がある +- `src/lib/redis.ts`からの既存のRedis接続を使用する +``` +```--- ## GPTモデル（GPT-5、GPT-5.1、Codex） -GPTモデルは明確なシステムレベルのコンテキストで優れ、明示的な役割設定から恩恵を受けます。 +GPTモデルは明確なシステムレベルのコンテキストで優秀な性能を発揮し、明示的な役割の設定から恩恵を受けます。 -### GPTの主要テクニック +### GPTの主要なテクニック - - GPT models respond well to clear role definitions: + + GPTモデルは明確な役割定義によく反応します： ``` You are a senior TypeScript developer reviewing code for a production e-commerce platform. Focus on: type safety, error handling, and performance. Review this checkout flow implementation... - ``` - + ``` - - GPT follows numbered instructions reliably: + + GPTは番号付きの指示に確実に従います： ``` Complete these steps in order: @@ -223,11 +213,10 @@ GPTモデルは明確なシステムレベルのコンテキストで優れ、 4. Update all call sites to use the new utility 5. Add unit tests for the utility 6. Run the test suite and fix any failures - ``` - + ``` - - Specify exactly what you want: + + 正確に何が欲しいかを指定してください： ``` Return your analysis as a markdown document with these sections: @@ -235,15 +224,12 @@ GPTモデルは明確なシステムレベルのコンテキストで優れ、 ## Issues Found (bulleted list) ## Recommended Changes (numbered, in priority order) ## Code Examples (if applicable) - ``` - + ``` -### GPTプロンプト改良スキル +### GPT プロンプトリファイナースキル -`~/.factory/skills/prompt-refiner-gpt/SKILL.md`を作成してください： - -```markdown +`~/.factory/skills/prompt-refiner-gpt/SKILL.md` を作成する：```markdown --- name: prompt-refiner-gpt description: Refine prompts for GPT models (GPT-5, GPT-5.1, Codex) using OpenAI's best practices. Use when preparing complex tasks for GPT. @@ -303,64 +289,59 @@ Present with: "Review this code for security issues" **After:** -``` -あなたはNode.js決済処理サービスのセキュリティ監査を実施するシニアセキュリティエンジニアです。 +```あなたはNode.js決済処理サービスのセキュリティ監査を実施するシニアセキュリティエンジニアです。 -コンテキスト：このサービスはクレジットカード取引を処理し、StripeのAPIと通信します。AWS ECSで実行されています。 +コンテキスト: このサービスはクレジットカード取引を処理し、StripeのAPIと通信します。AWS ECSで動作しています。 -タスク：src/payments/のコードをセキュリティ脆弱性についてレビューしてください。 +タスク: セキュリティ脆弱性について`src/payments/`内のコードをレビューしてください。 -手順： -1. 全てのエンドポイントで適切な入力検証を確認 -2. シークレットがハードコードされていない、またはログに記録されていないことを確認 -3. 認証・認可ロジックをレビュー -4. SQLインジェクションとXSS脆弱性を確認 -5. 機密情報を漏らさない適切なエラーハンドリングを確認 +手順: +1. すべてのエンドポイントで適切な入力検証をチェック +2. シークレットがハードコードされていないか、ログに記録されていないかを確認 +3. 認証と認可ロジックをレビュー +4. SQLインジェクションとXSS脆弱性をチェック +5. 機密情報を漏洩しない適切なエラーハンドリングを確認 -出力形式： -以下を含むmarkdown形式のセキュリティレポートを返してください： -- **Critical**：デプロイメント前に修正が必要な問題 -- **High**：早急に対処すべき重大なリスク -- **Medium**：検討すべき改善点 -- **Recommendations**：一般的なセキュリティ強化 +出力形式: +以下の項目を含むmarkdown形式のセキュリティレポートを返してください: +- **Critical**: デプロイ前に必ず修正すべき問題 +- **High**: 早急に対処すべき重大なリスク +- **Medium**: 検討すべき改善点 +- **Recommendations**: 一般的なセキュリティ強化 -各問題について以下を含める： +各問題について、以下を含めてください: - ファイルと行番号 - 脆弱性の説明 -- コード例付きの推奨修正 -``` -``` - ---- +- コード例を含む推奨修正方法``` +```--- -## Geminiモデル +## Gemini モデル -Geminiモデルは長いコンテキストをうまく処理し、構造化された推論で効果的に動作します。 +Gemini モデルは長いコンテキストを適切に処理し、構造化された推論と効果的に連携します。 -### Geminiの主要テクニック +### Gemini の主要なテクニック - - Gemini can handle extensive context—don't be afraid to include more background: + + Gemini は広範囲なコンテキストを処理できます—より多くの背景情報を含めることを恐れる必要はありません： ``` Here's the full module structure for context: [include relevant files] Based on these patterns, implement a new service that... - ``` - + ``` - - Gemini supports Low and High reasoning. Use High for: - - Architecture decisions - - Complex debugging - - Multi-step planning + + Geminiは低レベルと高レベルの推論をサポートしています。高レベルを使用する場面： + - アーキテクチャの決定 + - 複雑なデバッグ + - 多段階の計画 - Use Low for: - - Straightforward implementations - - Code generation from specs - - Routine refactoring + 低レベルを使用する場面： + - 簡単な実装 + - 仕様からのコード生成 + - 定型的なリファクタリング @@ -368,24 +349,22 @@ Geminiモデルは長いコンテキストをうまく処理し、構造化さ ## モデル選択戦略 -タスクにモデルをマッチさせる： +タスクに適したモデルを選択してください： | タスクタイプ | 推奨モデル | 推論レベル | |-----------|-------------------|-----------------| -| **複雑なアーキテクチャ** | Opus 4.6または Opus 4.5 | High-Max | -| **機能実装** | Sonnet 4.5またはGPT-5.1-Codex | Medium | -| **クイック編集、フォーマット** | Haiku 4.5 | Off/Low | +| **複雑なアーキテクチャ** | Opus 4.6 または Opus 4.5 | High-Max | +| **機能実装** | Sonnet 4.5 または GPT-5.1-Codex | Medium | +| **簡単な編集、フォーマット** | Haiku 4.5 | Off/Low | | **コードレビュー** | GPT-5.1-Codex-Max | High | -| **バルク自動化** | GLM-4.7 (Droid Core) | None | -| **リサーチ/分析** | Gemini 3 Pro | High | +| **一括自動化** | GLM-4.7 (Droid Core) | None | +| **調査/分析** | Gemini 3 Pro | High | --- -## 独自プロンプト改良の作成 - -チーム固有のニーズのために、カスタムプロンプト改良を作成してください： +## 独自のプロンプトリファイナーの作成 -```markdown +チーム固有のニーズに対応するため、カスタムプロンプトリファイナーを作成してください：```markdown --- name: prompt-refiner-team description: Refine prompts using our team's conventions and project context. @@ -405,45 +384,41 @@ description: Refine prompts using our team's conventions and project context. 4. [ ] Includes acceptance criteria ## Template -``` -コンテキスト：[既存のもの、モジュール/レイヤー] -タスク：[具体的なアクション] -従うべきパターン：[既存の類似コードを参照] -テスト：[追加/更新するテスト] -完了条件：[受け入れ基準] -``` -``` - ---- +```コンテキスト: [何が存在するか、どのモジュール/レイヤー] +タスク: [具体的なアクション] +従うべきパターン: [既存の類似コードを参照] +テスト: [追加/更新すべきテスト] +完了条件: [受け入れ基準]``` +```--- ## クイックリファレンスカード -### Claude（Opus/Sonnet/Haiku） +### Claude (Opus/Sonnet/Haiku) - ✅ 構造化のためのXMLタグ - ✅ 指示の前にコンテキスト -- ✅ 専用セクションでの例 +- ✅ 専用セクションでの例示 - ✅ 推論のための「Think through...」 -### GPT（GPT-5/Codex） -- ✅ 役割設定（「あなたは...」） -- ✅ 番号付き手順 +### GPT (GPT-5/Codex) +- ✅ 役割の設定（「You are a...」） +- ✅ 番号付きステップ手順 - ✅ 明示的な出力形式 -- ✅ 推論のための「ステップバイステップ」 +- ✅ 推論のための「Step by step」 ### Gemini -- ✅ 広範囲なコンテキスト包含 -- ✅ Low/High推論レベル -- ✅ 構造化された出力リクエスト +- ✅ 広範囲なコンテキストの包含 +- ✅ 低/高推論レベル +- ✅ 構造化された出力要求 --- ## 次のステップ - - Complete power user configuration + + パワーユーザー設定を完了する - - Reduce costs while maintaining quality + + 品質を保ちながらコストを削減する \ No newline at end of file diff --git a/docs/jp/guides/power-user/setup-checklist.mdx b/docs/jp/guides/power-user/setup-checklist.mdx index 4e879b2..84f26ce 100644 --- a/docs/jp/guides/power-user/setup-checklist.mdx +++ b/docs/jp/guides/power-user/setup-checklist.mdx @@ -1,39 +1,39 @@ --- -title: "パワーユーザーセットアップチェックリスト" -description: Complete checklist to configure Droid for maximum effectiveness with IDE integration, memory, skills, and automation. +title: Power User Setup Checklist +description: DroidをIDE統合、メモリ、スキル、自動化で最大効果を発揮するための完全設定チェックリスト keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', 'productivity', 'best practices'] --- -このチェックリストは、基本的なDroidインストールを完全に最適化された開発環境に変換します。各セクションは前のセクションをベースに構築されているため、最良の結果を得るためには順番通りに完了してください。 +このチェックリストは、基本的なDroidインストールを完全に最適化された開発環境に変換します。各セクションは前のセクションの上に構築されています—最良の結果を得るために順番に完了してください。 - Each section can be done independently if you prefer to spread it out. + 各セクションは、必要に応じて分散して独立して実行できます。 - **Using Factory App?** Most of this guide applies to both CLI and [Factory App](/web/getting-started/overview). Where the experience differs, we've noted the App-specific approach. + **Factory Appを使用していますか？** このガイドのほとんどはCLIと[Factory App](/jp/web/getting-started/overview)の両方に適用されます。体験が異なる場合は、App固有のアプローチを記載しています。 --- -## レベル1：基本セットアップ +## レベル1: 必須セットアップ -これらの基盤となる項目は、最大の即時効果をもたらします。 +これらの基本項目は、最大の即効性をもたらします。 - - The IDE plugin provides real-time context—open files, errors, selections—so Droid sees what you see. + + IDEプラグインは、開いているファイル、エラー、選択範囲などのリアルタイムコンテキストを提供し、Droidがあなたが見ているものを見ることができます。 **VSCode/Cursor:** - 1. Open Extensions (`Cmd+Shift+X`) - 2. Search "Factory" - 3. Install and reload + 1. Extensions (`Cmd+Shift+X`) を開く + 2. "Factory" を検索 + 3. インストールしてリロード - **Verify:** Run `droid` and check for "IDE connected" in the status bar. + **確認:** `droid` を実行し、ステータスバーで "IDE connected" を確認してください。 - - Create a basic [`AGENTS.md`](/cli/configuration/agents-md) at your repository root: + + リポジトリルートに基本的な [`AGENTS.md`](/jp/cli/configuration/agents-md) を作成します： ```markdown # Project Guidelines @@ -47,40 +47,36 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - Use TypeScript strict mode - Prefer functional components in React - Write tests for new features - ``` - - Start minimal—you'll expand this as you work. See the [AGENTS.md guide](/cli/configuration/agents-md) for more examples. + ```最小限から始めて、作業しながら拡張していきます。より多くの例については、[AGENTS.mdガイド](/jp/cli/configuration/agents-md)を参照してください。 - - Set your preferred model in settings: + + 設定で希望するモデルを設定します： - **CLI:** - ```bash + **CLI:**```bash droid > /settings # Navigate to Model and select your default ``` + **Factory App:** チャットインターフェースのモデル選択ドロップダウンを使用します。 - **Factory App:** Use the model selector dropdown in the chat interface. - - **Recommendation:** Start with Claude Opus 4.5 (default) for complex work, switch to Haiku 4.5 or GPT-5.1-Codex for routine tasks. + **推奨事項:** 複雑な作業にはClaude Opus 4.5（デフォルト）から始めて、日常的なタスクにはHaiku 4.5やGPT-5.1-Codexに切り替えてください。 - **Checkpoint:** You should now have IDE integration, basic project context, and your preferred model configured. + **チェックポイント:** IDE統合、基本的なプロジェクトコンテキスト、および優先モデルの設定が完了している必要があります。 --- -## レベル2：メモリ＆コンテキスト +## レベル2: メモリ＆コンテキスト -永続的なメモリを構築し、Droidがセッション間であなたの設定を記憶できるようにします。 +Droidがセッション間であなたの設定を記憶できるように、永続的なメモリを構築します。 - - Create `~/.factory/memories.md` for personal preferences: + + 個人の設定用に`~/.factory/memories.md`を作成します： ```markdown # My Development Preferences @@ -99,21 +95,19 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - [2024-01] Chose Zustand over Redux for state management - [2024-02] Using Tailwind CSS for styling ``` - - Update this file whenever you find yourself repeating instructions to Droid. + Droidに同じ指示を繰り返している場合は、このファイルを更新してください。 - - Add to your `AGENTS.md`: + + `AGENTS.md`に以下を追加してください： ```markdown ## Personal Preferences Refer to `~/.factory/memories.md` for my coding preferences and past decisions. - ``` - + ``` - - For team projects, create `.factory/memories.md`: + + チームプロジェクトの場合、`.factory/memories.md`を作成します： ```markdown # Project Memories @@ -126,27 +120,26 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', ## Known Issues - The auth service has a 5-second timeout issue (#123) - Legacy users table uses snake_case columns - ``` - + ``` - **Checkpoint:** Droid now has access to your preferences and project history without you repeating them. + **チェックポイント:** Droidが、あなたが繰り返し説明することなく、あなたの設定とプロジェクト履歴にアクセスできるようになりました。 - **Want automated memory capture?** Set up a hook to automatically save memories when you say "remember this:". See [Memory Management](/guides/power-user/memory-management#automatic-memory-capture) for setup instructions. + **自動メモリキャプチャが欲しいですか？** 「これを覚えて：」と言ったときに自動的にメモリを保存するフックを設定してください。設定手順については[メモリ管理](/jp/guides/power-user/memory-management#automatic-memory-capture)をご覧ください。 --- -## レベル3：ルール＆規約 +## レベル3: ルールと規約 -コーディング標準を整理し、Droidが一貫してそれらに従うようにします。 +Droidが一貫して従うようにコーディング標準を整理します。 - - Create `.factory/rules/` in your project: + + プロジェクトに `.factory/rules/` を作成します： ``` .factory/ @@ -154,11 +147,10 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', ├── typescript.md ├── testing.md └── security.md - ``` - + ``` - - Create `.factory/rules/typescript.md`: + + `.factory/rules/typescript.md`を作成： ```markdown # TypeScript Conventions @@ -177,11 +169,10 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - Group imports: React, external libs, internal modules, types - Use absolute imports from `@/` prefix - Avoid barrel files (index.ts re-exports) for performance - ``` - + ``` - - Create `.factory/rules/testing.md`: + + `.factory/rules/testing.md`を作成します: ```markdown # Testing Conventions @@ -200,11 +191,10 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - Mock at the boundary (API calls, not internal functions) - Use MSW for API mocking in integration tests - Reset mocks in `afterEach` - ``` - + ``` - - Update your `AGENTS.md`: + + `AGENTS.md`を更新してください： ```markdown ## Coding Standards @@ -212,34 +202,33 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - `.factory/rules/typescript.md` - TypeScript and React patterns - `.factory/rules/testing.md` - Testing conventions - `.factory/rules/security.md` - Security requirements - ``` - + ``` - **Checkpoint:** Your coding standards are now documented and Droid will follow them consistently. + **チェックポイント:** コーディング標準が文書化され、Droidが一貫して従うようになりました。 - **Enforce rules automatically:** Use [PostToolUse hooks](/cli/configuration/hooks-guide) to run linters after edits. See [Code Validation hooks](/guides/hooks/code-validation) for examples. + **ルールを自動的に実行:** 編集後にリンターを実行するには[PostToolUse hooks](/jp/cli/configuration/hooks-guide)を使用してください。例については[Code Validation hooks](/jp/guides/hooks/code-validation)をご覧ください。 --- -## レベル4：スキル＆自動化 +## レベル4: スキルと自動化 再利用可能なスキルと自動化フックを追加します。 - **Three ways to automate:** - - **[Skills](/cli/configuration/skills)** — Droid invokes them based on task context - - **[Hooks](/cli/configuration/hooks-guide)** — Run automatically on specific events - - **[Custom Slash Commands](/cli/configuration/custom-slash-commands)** — You invoke with `/command-name` + **自動化の3つの方法:** + - **[Skills](/jp/cli/configuration/skills)** — Droidがタスクコンテキストに基づいて呼び出す + - **[Hooks](/jp/cli/configuration/hooks-guide)** — 特定のイベントで自動実行 + - **[Custom Slash Commands](/jp/cli/configuration/custom-slash-commands)** — `/command-name`で自分で呼び出す - - Create `~/.factory/skills/prompt-refiner/SKILL.md`: + + `~/.factory/skills/prompt-refiner/SKILL.md`を作成: ```markdown --- @@ -268,11 +257,10 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', - Include acceptance criteria: "The result should..." - Specify format: "Return as JSON/markdown/code" - Mention constraints: "Must be compatible with...", "Should not modify..." - ``` - + ``` - - Run `/hooks` and add a PostToolUse hook for automatic formatting: + + `/hooks`を実行し、自動フォーマット用のPostToolUseフックを追加してください： ```json { @@ -290,13 +278,11 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', ] } } - ``` - - This automatically formats files after Droid edits them. + ```このステップは、Droidがファイルを編集した後に自動的にフォーマットします。 - - Run related tests after edits: + + 編集後に関連するテストを実行： ```json { @@ -314,57 +300,51 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', ] } } - ``` - + ``` - **Checkpoint:** You now have reusable skills and automatic formatting/testing. + **チェックポイント:** これで再利用可能なスキルと自動フォーマット/テストが設定できました。 --- -## レベル5：トークン最適化 +## レベル 5: トークン最適化 -品質を犠牲にすることなく、コスト効率を微調整します。 +品質を犠牲にすることなくコスト効率を向上させましょう。 - - Use `Shift+Tab` or `/spec` before starting features that touch multiple files. This prevents expensive false starts. + + 複数ファイルに影響する機能を開始する前に、`Shift+Tab` または `/spec` を使用してください。これにより高コストな誤ったスタートを防げます。 - - Set up a spec mode model for planning: + + プランニング用のspec modeモデルを設定します： ```bash droid > /settings # Set Spec Mode Model to a reasoning-heavy model - ``` - - Use Opus 4.5 for planning, then Sonnet or Codex for implementation. + ```計画にはOpus 4.5を使用し、実装にはSonnetまたはCodexを使用してください。 - - Check your project's AI-readiness: + + プロジェクトのAI対応状況を確認してください： - **CLI:** - ```bash + **CLI:**```bash droid > /readiness-report - ``` - - **Factory App:** View your readiness score in the [Agent Readiness Dashboard](/web/agent-readiness/dashboard). - - Address high-impact items first—linting, type checking, and fast tests dramatically reduce token waste. + ```**Factory App:** [Agent Readiness Dashboard](/jp/web/agent-readiness/dashboard)で準備状況スコアを確認してください。 + + 高影響度の項目から対処してください。リンティング、型チェック、高速テストにより、トークンの無駄を劇的に削減できます。 --- -## クイックリファレンス：ファイルの場所 +## クイックリファレンス: ファイルの場所 -| 目的 | 個人用 | プロジェクト用 | +| 用途 | 個人 | プロジェクト | |---------|----------|---------| | **スキル** | `~/.factory/skills//SKILL.md` | `.factory/skills//SKILL.md` | | **メモリ** | `~/.factory/memories.md` | `.factory/memories.md` | @@ -372,7 +352,7 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', | **設定** | `~/.factory/settings.json` | `.factory/settings.json` | | **フック** | settings.json内 | settings.json内 | | **エージェント指示** | `~/.factory/AGENTS.md` | `./AGENTS.md` | -| **カスタムdroid** | `~/.factory/droids/.md` | `.factory/droids/.md` | +| **カスタムドロイド** | `~/.factory/droids/.md` | `.factory/droids/.md` | --- @@ -380,29 +360,29 @@ keywords: ['power user', 'setup', 'checklist', 'configuration', 'optimization', セットアップを検証するために、このチェックリストを実行してください： -- [ ] Droid実行時にIDEプラグインが「接続済み」を表示する -- [ ] `AGENTS.md`がbuild/testコマンドと共に存在する -- [ ] あなたの設定を含むメモリファイルが作成されている -- [ ] 少なくとも1つのルールファイルがあるルールディレクトリが存在する -- [ ] 少なくとも1つのカスタムスキルが作成されている -- [ ] 自動フォーマットフックが設定されている -- [ ] 準備状況レポートがレベル2以上を表示する +- [ ] IDEプラグインがDroid実行時に「接続済み」を表示 +- [ ] `AGENTS.md`がビルド/テストコマンドと共に存在 +- [ ] 設定を記載したメモリファイルが作成済み +- [ ] 少なくとも1つのルールファイルを含むルールディレクトリ +- [ ] 少なくとも1つのカスタムスキルを作成済み +- [ ] 自動フォーマットフックが設定済み +- [ ] 準備状況レポートがレベル2以上を表示 --- ## 次のステップ - - Learn model-specific prompting techniques + + モデル固有のプロンプティング技術を学ぶ - - Strategies for reducing token usage + + トークン使用量を削減する戦略 - - Advanced memory and context patterns + + 高度なメモリとコンテキストパターン - - Organizing team conventions effectively + + チーム規約を効果的に整理する \ No newline at end of file