核心理念: 不要试图让AI直接“生成最终代码”,而是利用AI“生成中间设计文档”。
在日本,文档即代码(Documentation is Code)。只要我们将重心放在利用AI生成高质量的《详细设计书》,代码只是顺理成章的产物。
一、 语言与Prompt策略:克服“日语暧昧”与“外语劣势”
直接用蹩脚的日语写Prompt,或者直接用中文Prompt让AI输出日语,往往会导致“似是而非”的日语,这在严格的日本职场是致命的。我们需要引入“中间语言层”。
策略 1: C-E-J 三明治法 (Chinese - English - Japanese)
目前主流大模型(GPT-4, Claude 3.5)的逻辑推理核心是英语。英语的逻辑密度比日语高,且没有敬语的干扰。
- 思考 (Input): 用你的母语(中文)或者简单的英语列出逻辑要点。
- 推理 (Chain of Thought): 强制AI用英语进行逻辑推理和结构化设计(这是AI最强状态)。
- 输出 (Output): 指定AI将最终结果翻译为“日本的商务/技术日语 (Business/Technical Japanese)”。
优势: 避免了中文直译日语带来的违和感,利用英语作为逻辑锚点,保证了技术准确性。
策略 2: 结构化提示词 (Structured Prompting)
不要写散文,要写配置单。利用 Markdown 或 JSON 格式来约束 AI,减少日语语法对指令的影响。
# Context
You are a veteran Japanese System Engineer (SE) with 20 years of experience in generic SIer.
# Goal
Create a "Detailed Design Document" based on the input logic.
# Input Logic (Chinese/English mixed is fine)
- 用户登录功能
- 需要检查输入是否为空
- 密码错误3次锁定
# Output Rules
- Language: Japanese (Strict Formal Keigo/Technical Style)
- Format: Markdown Table
- Style: Use "だ・である" body for specs, "です・ます" for notes.
- Terminology: Use standard IPA (Information-technology Promotion Agency) terms.
二、 针对瀑布流各阶段的 AI 导入方案
日本的瀑布流强调“工程管理”和“证据(Evidence)”。我们可以让AI辅助生成这些证据。
1. 基本设计 (Basic Design) 阶段
痛点: 需求理解偏差,日语表达不地道。
AI解法: 反向确认 歧义消除
不要急着设计,先将从日方拿到的需求(日语)喂给AI,让AI用中文给你解释一遍,确认理解无误。然后,让AI列出“可能存在的歧义点”,你拿着这些点去和日方确认。这会让你看起来非常专业。
Prompt: "Here is the requirement text in Japanese. Please identify any ambiguous points that a developer needs to confirm before design. List them in a table (Japanese Question vs Chinese Explanation)."
2. 详细设计 (Detailed Design) 阶段 —— 关键战场
痛点: 日本的详细设计书(Excel/Word)细致到变量名、异常处理,且文字量巨大。
AI解法: 伪代码转文档
这就是你发挥“Vibe Coding”的地方,但不是生成代码,是生成文档。你可以用中文或简单的伪代码写出逻辑,让AI转换成“日式详细设计书风格”的文本。
- 输入: "如果用户ID空,报错E001。连接DB失败,重试3次。"
- Prompt要求: "Convert this logic into a Japanese Detailed Design format. Include 'Processing Flow', 'Input/Output', and 'Exception Handling'."
- 结果: AI会生成非常标准的日语描述,如「・ユーザーIDが空の場合、エラー(E001)を送出すること。」
3. 制造 (Coding) 阶段
痛点: 变量命名(英文水平)、注释(日文水平)。
AI解法: 命名规范 自动注释
让AI生成符合团队规约(Coding Guideline)的代码。特别强调:生成日语注释。这对日后的代码Review(レビュー)至关重要。
// 提示词示例
"Generate Java code for the login logic.
Constraints:
1. Variable names must follow CamelCase.
2. Add Javadoc in Japanese for every method.
3. Comments must explain 'Why', not just 'What'."
三、 具体实施:构建你的“日语Prompt库”
为了解决临场写Prompt难的问题,建议建立一个个人专属的 Prompt Snippets (提示词片段库)。每次只需填空。
通用修正指令 (Refinement Prompt):
当你觉得AI生成的日语有点怪,或者自己写好了一段日语设计书想润色时,使用以下Prompt:
# Role
Professional Japanese Technical Writer / Senior SE.
# Task
Refine the following Japanese text intended for a Detailed Design Document.
# Rules
1. Correct any unnatural expressions for a native Japanese speaker.
2. Ensure strict consistency in terminology.
3. Remove ambiguous words (e.g., avoid "多分", "等", use specific definitions).
4. Tone: Formal Technical Writing (言い切り型).
# Text to Refine
[粘贴你的日语草稿]
四、 总结与建议
作为中国工程师,我们必须承认语言和文化的壁垒。但AI恰恰是打破这道墙的工具。
- 扬长避短: 用中文/英语思考逻辑(这是你的强项),用AI翻译成标准的日式文档(这是AI的强项)。
- 拥抱瀑布: 不要抵触文档。利用AI快速生成高质量文档,会让你在日本职场获得极高的信任度(信頼関係)。
- 人工审查: 永远不要直接复制粘贴。AI生成的日语虽然语法正确,但可能缺乏上下文的“空气感”(KY)。最终必须由你亲自确认。