docs: add AGENTS.md for repo workflow#113
docs: add AGENTS.md for repo workflow#113Wind-DeterMination-backup wants to merge 4 commits intoTinyLake:mainfrom
Conversation
Summary of ChangesHello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed! This pull request significantly enhances the project's documentation by adding AGENTS.md, a comprehensive guide designed to onboard new contributors and standardize development practices within the MindustryX repository. The document clarifies the repository's unique patch-first workflow, outlines essential build and validation procedures, and provides detailed best practices for coding, UI/internationalization, and the pull request review cycle. This addition aims to streamline the contribution process, improve code quality, and foster a more consistent development environment for all participants. Highlights
🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console. Changelog
Using Gemini Code AssistThe full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips. Invoking Gemini You can request assistance from Gemini at any point by creating a comment using either
Customization To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a Limitations & Feedback Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here. You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension. Footnotes
|
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
| - UI 适配优先复用现有 `Table` 和项目已有布局能力,不要依赖硬编码宽高阈值或“挤不下就换行”的补丁式布局。 | ||
| - 信息展示优先使用结构化组件,不要把多段信息、颜色、状态和换行需求都堆进字符串拼接。 | ||
| - 不要用字符串拼接生成富文本或颜色标记文本,例如 `"[accent]" + text + "[]"`;优先拆成独立 `Label`/`Cell`,或直接对组件设置颜色、样式和布局。 | ||
| - 不要滥用 `i(...)` 内联国际化 helper。正式、长期存在、可复用的 UI 文案优先写入 bundle;`i(...)` 更适合少量局部文本或确实不值得沉淀 bundle 的场景。 |
| - 临时产物路径(如手工回写 `MindustryX-temp.jar`)只能用于快速验证,不能代替 patch 再生成与正式构建链路。 | ||
|
|
||
| ## 改动约束 | ||
| - 保持改动最小化、局部化,不要借修一个点顺手做风格化重构或无关清理。 |
There was a problem hiding this comment.
新增:patches改动应该最小化,能在src实现不依赖patch。同一个功能的patch应该合并,而不是新建。
There was a problem hiding this comment.
.github下面还有个copilot文件,合并到一起,可以删除旧文件。
Add a repository-level AGENTS.md summarizing the patch-first workflow, build/validation entry points, UI/i18n review preferences, and PR handling guidance.