|
1 | 1 | # TestPilot AI - Project Coding Standards |
2 | 2 |
|
3 | | -## Language Rule (MANDATORY) |
4 | | - |
5 | | -All AI thinking, reasoning, and responses MUST be in **English**. This applies to: |
6 | | -- Code comments in new/modified code |
7 | | -- Commit messages |
8 | | -- AI-generated explanations and dialog |
9 | | -- Variable/function naming (already English) |
10 | | - |
11 | | -Exception: User-facing strings in the product (UI text, log messages, prompts sent to AI models) may remain in Chinese as they are part of the product's Chinese localization. |
12 | | - |
13 | | ---- |
| 3 | +# Language Rule (MANDATORY) |
| 4 | +- 你必须全程使用中文进行思考、推理、回答和对话。 |
| 5 | +- 只有代码、专业名词、关键字等必须使用英文的地方,才可保留英文,其余内容一律使用中文。 |
| 6 | + |
| 7 | +# Core Workflow: 4-Step Method |
| 8 | +1. 任务分析:分析需求、技术难点,默认使用北京时间。 |
| 9 | +2. 实施规划:制定 3–5 个步骤,Python 项目第一步必须包含虚拟环境设置。 |
| 10 | +3. 分步执行:单次代码输出严格限制在 **100 行以内**,复杂任务分批次输出。 |
| 11 | +4. 总结回顾:提供代码使用说明和注意事项。 |
| 12 | + |
| 13 | +# Key Optimization Specifications |
| 14 | +- 代码生成控制:避免卡顿,严禁一次性生成超长代码。 |
| 15 | +- Python 专项:强制使用虚拟环境,代码中显式指定 Asia/Shanghai 时区。 |
| 16 | +- 项目文档管理:每个项目必须创建并实时维护 开发备忘录.md 文件。 |
| 17 | + |
| 18 | +# Project Documentation Mandatory Requirements |
| 19 | +## 文件位置 |
| 20 | +项目根目录下的 开发备忘录.md |
| 21 | + |
| 22 | +## 实时同步 |
| 23 | +每次代码修改、Bug 修复、功能更新后,必须同步更新该备忘录。 |
| 24 | + |
| 25 | +## 核心内容 |
| 26 | +- 项目简介与核心功能 |
| 27 | +- 环境配置(重点强调 python -m venv venv) |
| 28 | +- 开发、测试与部署步骤 |
| 29 | +- 版本更新日志(明确标注已淘汰的旧代码和新增功能) |
| 30 | +- 已知问题与解决方案 |
| 31 | + |
| 32 | +## 更新原则 |
| 33 | +确保代码与文档完全一致,淘汰内容需特别注明。 |
| 34 | + |
| 35 | +# Interaction & Output Rules |
| 36 | +- 全程使用简洁专业的简体中文。 |
| 37 | +- 代码注释重点解释核心逻辑,避免冗长。 |
| 38 | +- 分批次输出代码时,需明确标注进度(例如:[第1/3部分])。 |
| 39 | +- 代码长度超过 100 行时,必须分段输出,每段不超过 100 行。 |
14 | 40 |
|
15 | 41 | ## 蓝本文件(testpilot.json)管理规则 |
16 | 42 |
|
@@ -380,48 +406,3 @@ Flutter 的 `Semantics` 组件在 Android 端映射为无障碍属性。**选择 |
380 | 406 |
|
381 | 407 | > Flutter 每次 `navigate` 重启后的标准流程:先 `wait 3000`,再 `wait target` 等关键元素就绪。 |
382 | 408 |
|
383 | | -核心工作流程:四步法 |
384 | | - |
385 | | -任务分析:分析需求、技术难点,默认使用北京时间。 |
386 | | - |
387 | | -实施规划:制定3-5个步骤,Python项目第一步必须包含虚拟环境设置。 |
388 | | - |
389 | | -分步执行:单次代码生成严格限制在150行以内,复杂任务分批次进行。 |
390 | | - |
391 | | -总结回顾:提供代码使用说明和注意事项。 |
392 | | - |
393 | | -重点优化规范 |
394 | | - |
395 | | -代码生成控制:避免卡顿,严禁一次性生成超长代码。 |
396 | | - |
397 | | -Python专项:强制使用虚拟环境,代码中显式指定 Asia/Shanghai时区。 |
398 | | - |
399 | | -项目文档管理:每个项目必须创建并实时维护 开发备忘录.md文件。 |
400 | | - |
401 | | -项目文档强制要求 |
402 | | - |
403 | | -文件位置:项目根目录下的 开发备忘录.md。 |
404 | | - |
405 | | -实时同步:每次代码修改、Bug修复、功能更新后,必须同步更新该备忘录。 |
406 | | - |
407 | | -核心内容: |
408 | | - |
409 | | -项目简介与核心功能。 |
410 | | - |
411 | | -环境配置(重点强调 python -m venv venv)。 |
412 | | - |
413 | | -开发、测试与部署步骤。 |
414 | | - |
415 | | -版本更新日志(明确标注已淘汰的旧代码和新增功能)。 |
416 | | - |
417 | | -已知问题与解决方案。 |
418 | | - |
419 | | -更新原则:确保代码与文档完全一致,淘汰内容需特别注明。 |
420 | | - |
421 | | -交互与输出 |
422 | | - |
423 | | -全程使用简洁专业的简体中文。 |
424 | | - |
425 | | -代码注释重点解释核心逻辑,避免冗长。 |
426 | | - |
427 | | -分批次输出代码时,需明确标注进度(例如:[第1/3部分])。 |
0 commit comments