Conversation
mnriem
added
the
triage-nice-to-have
There was a problem hiding this comment.
🟡 Changes recommended
The translation contains inconsistent SDD terminology and several formatting errors.
Get a fresh assessment by requesting another Copilot review.
Pull request overview
Adds a Japanese README and connects it to the existing language switchers.
Changes:
- Adds the Japanese translation.
- Adds Japanese navigation links to existing READMEs.
File summaries
| File | Description |
|---|---|
README.ja.md |
Adds Japanese documentation. |
README.md |
Links to the Japanese README. |
README.zh-CN.md |
Links to the Japanese README. |
Review details
Suppressed comments (3)
README.ja.md:78
- The sentence is ended before the command reference and then punctuated again, unlike steps 1–4. Move the command parenthetical before the sentence-ending mark.
5. **収束させる(Converge)**: 実装が仕様・計画・タスクと一致しているかを検証し、ズレを収束させます。(`/speckit-converge`)。
README.ja.md:441
- The linked methodology is called
仕様駆動開発throughout this translation (for example, lines 57–59 and 380), so規範駆動開発is an inconsistent and meaning-changing translation here.
- **[規範駆動開発の完全な方法論](./spec-driven.md)** - プロセス全体を深く掘り下げる
README.ja.md:448
- The support text again switches from the established
仕様駆動開発terminology to規範駆動開発, which refers to norms rather than specifications.
サポートが必要な場合は、[GitHub issue](https://github.com/github/spec-kit/issues/new) を開いてください。バグ報告、機能リクエスト、規範駆動開発の使い方に関する質問を歓迎します。
- Files reviewed: 3/3 changed files
- Comments generated: 8
- Review effort level: Balanced
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| <a href="./README.md">English</a>· | ||
| <a href="./README.zh-CN.md">简体中文</a>· |
|
|
||
| ## 🤔 仕様駆動開発とは? | ||
|
|
||
| 仕様駆動開発(Spec Driven Development)は、従来のソフトウェア開発の常識を覆します。これまで何十年もの間、コードこそが主役であり、仕様書はコーディングという"本当の仕事"が始まれば捨てられる、単なる踏み台に過ぎませんでした。仕様駆動開発はこれを一変させます ―― 仕様書自体が実行可能になり、単に実装の指針を示すのではなく、動くソフトウェアを直接作り出すのです。 |
|
|
||
| プロジェクトディレクトリでコーディングエージェントを起動します。 | ||
|
|
||
| 0. **確立する(Establish)**: プロジェクトのルールを最初に一度だけ定義します。(`/speckit-constitution`)。プロジェクトごとに1回だけ行うステップです。 |
| uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z | ||
| ``` | ||
|
|
||
| PyPIからのインストールがお好みですか?specify-cli パッケージはPyPIにも公開されています。 |
|
|
||
| ### 3. プロジェクトルールを定義する | ||
|
|
||
| プロジェクトディレクトリでコーディングエージェントを起動します。ほとんどのエージェントは spec-kit を `/speckit.*` というスラッシュコマンドとして公開していますが、Codex CLI とスキルモードの Command Code は代わりに `$speckit-*` を使用します。GitHub Copilot CLI では /agents でエージェントを選択するか、プロンプト内で直接指定します。 |
| /speckit.plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript as much as possible. Images are not uploaded anywhere and metadata is stored in a local SQLite database. | ||
| ``` | ||
|
|
||
| ### 6.タスクに分解する |
| ### 技術非依存性 | ||
|
|
||
| - 多様な技術スタックを用いてアプリケーションを作成する | ||
| - 規範駆動開発が、特定の技術・プログラミング言語・フレームワークに縛られないプロセスであるという仮説を検証する |
| <a href="./README.md">English</a> · | ||
| <strong>简体中文</strong> | ||
| <strong>简体中文</strong> · | ||
| <a href="./README.ja.md">日本語</a> · |
|
Thanks for contributing a Japanese translation and reviewing the initial draft yourself. This follows the existing Chinese README approach. We substantially reorganized the README in #4591 after you opened this PR. Please refresh the Japanese version against current Please also add the Claude model(s) and mode/settings used to the disclosure. The extent of assistance and your subsequent review are already clear. Drafted for @mnriem with assistance from GitHub Copilot (model: GPT-6 Astra; interactive comment drafting). |
mnriem
added
author-needs-disclosure
cc4b004 to
4b47971
Compare
|
Thanks for the review! I've updated the AI Disclosure section to include the specific model and mode used. I've also refreshed the Japanese translation to match the restructured README. Please take a look. |
Description
Adds a Japanese translation of the project README as
README.ja.md.Spec Kit already has a Simplified Chinese translation (#3740) but no Japanese one, so this follows the same pattern.
New file
README.ja.md— a full Japanese translation.README.md— added日本語(japanese)to the language switcher under the badges.README.zh-CN.md— added日本語(japanese)to its language switcher as well.All code blocks, CLI commands, slash-command names, badges, image paths, and link URLs are unchanged — only prose and inline shell comments were translated.
Testing
This is a documentation-only change with no impact on CLI behavior or slash commands, so the checkboxes below don't apply.
uv run specify --help— N/A (docs-only change)uv sync && uv run pytest— N/A (docs-only change)Manual verification performed instead:
AI Disclosure
I used Claude Code (model: Claude Sonnet 5, interactive mode) to produce an initial draft translation, then reviewed and corrected it myself as a native Japanese speaker — rewriting phrasing to read naturally rather than as a literal machine translation, and checking terminology and links against the English source section by section.
Note
If documentation/translation contributions like this aren't something the project wants to take on right now, please feel free to close this — no hard feelings, and thanks for all the work maintaining Spec Kit!