GitBucket
Issue管理ワークフロー (Issue Management Workflow)
このリポジトリにおける Issue の管理および同期に関する運用ルールです。 These are the operational rules for managing and synchronizing issues in this repository.
1. 外部トラッカーとの同期 (Synchronization with External Tracker)
本プロジェクトでは、上流の Issue トラッカー (GitHub 互換 API) とローカルの Markdown ファイルを同期させて開発を進めます。 In this project, development proceeds by synchronizing the upstream issue tracker (GitHub-compatible API) with local Markdown files.
- 同期方向 (Direction): 原則として上流の Issue トラッカーが正（Source of Truth）です。 As a rule, the upstream issue tracker is the Source of Truth.
- 自動同期 (Auto-sync):
node tools/scripts/sync_issues.mjsを実行して、リモートの最新状態をdocs/issues/に反映、またはローカルの新規 Issue をリモートに作成します。 Runnode tools/scripts/sync_issues.mjsto reflect the latest remote state indocs/issues/or create new local issues on the remote. - Git追跡除外 (Git Ignore):
docs/issues/は.gitignoreにより Git 追跡から除外されています。docs/issues/is excluded from Git tracking via.gitignore.
2. 記述規約 (Writing Conventions)
- 日英併記の義務化 (Mandatory Bilingual Description):
- すべての Issue は日本語と英語を併記しなければなりません。 All issues must be written in both Japanese and English.
- 片方の言語だけで記述されている場合は、不足している言語の翻訳を補完してください。 If an issue is written in only one language, please supplement it with a translation in the missing language.
3. クローズとクリーンアップ (Closing and Cleanup)
- 手動クローズ (Manual Closing):
- トラッカー API の制約により、スクリプトからの自動クローズは行いません。 Due to tracker API constraints, automatic closing from scripts is not performed.
- 作業完了後、ローカル Markdown の
stateをclosedにして同期スクリプトを実行すると、手動クローズ用のURLが表示されます。 After completing work, set thestateof the local Markdown toclosedand run the sync script to display the URL for manual closing.
- ローカルの自動削除 (Local Auto-deletion):
- 上流トラッカー側で
closedになった Issue は、同期スクリプト実行時にローカルの Markdown ファイルが自動的に削除されます。 Issues that areclosedon the upstream tracker side will have their local Markdown files automatically deleted when the sync script is run.
- 上流トラッカー側で