Skip to content

Update AGENTS.md - #53

Merged
Bruce1986 merged 1 commit into
Docs/update-gemini-guidelinesfrom
Bruce1986-patch-1
Aug 14, 2025
Merged

Bruce1986 merged 1 commit into
Docs/update-gemini-guidelinesfrom
Bruce1986-patch-1

Conversation

@Bruce1986

Copy link
Copy Markdown
Owner

No description provided.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary of Changes

Hello @Bruce1986, 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!

此 Pull Request 主要更新了 AGENTS.md 文件。核心變更在於將文件內容從英文翻譯為繁體中文,並對其結構進行了重新組織。現在,該文件提供了更清晰的 AI 代理程式(例如 gemini-code-assist)協作指南,並明確了單元測試的要求,同時也保留並翻譯了原有的專案特定技術規範。

Highlights

  • 文件翻譯與本地化: 將 AGENTS.md 的內容從英文翻譯成繁體中文,以提升中文使用者的可讀性。
  • 指南結構重組: 重新組織了文件內容,將 AI 助理回饋處理和單元測試要求獨立成明確的章節。
  • AI 助理回饋處理規範: 明確要求處理 gemini-code-assist 的建議,並在未採納時提供理由。
  • 單元測試強制要求: 強調所有新功能必須包含單元測試,並在無法測試時提供解釋。
  • 保留並翻譯現有技術指南: 原有的專案特定技術指南(如 Node.js 版本、Gradle 配置、Python 支持等)被保留並翻譯。
Using Gemini Code Assist

The 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 in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

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 .gemini/ folder in the base of the repository. Detailed instructions can be found here.

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

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

這份 PR 主要將 AGENTS.md 文件本地化為繁體中文,並重新組織了內容結構,使其更加清晰。整體來看,這是一個好的改進。我唯一的建議是關於 AGENTS.mdGEMINI.md 之間內容重疊的問題,這可能會導致未來的維護困難。建議將兩者合併,以 AGENTS.md 作為單一的資訊來源。

Comment thread AGENTS.md
Comment on lines +1 to +3
# AI 代理程式協作指南

本文件旨在規範與 AI 代理程式(如 gemini-code-assist)在此專案中的協作方式,以確保程式碼品質與開發流程的一致性。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

感謝您對 AGENTS.md 進行本地化和結構重組,這讓文件更清晰易讀。

在審查過程中,我注意到專案中還有一個 GEMINI.md 檔案,其內容與 AGENTS.md 中關於 AI 助理的部分有許多重疊之處。例如,兩個檔案都提到了 gemini-code-assist 的使用和處理建議的指南。

為了避免未來維護上的混淆和不一致,建議考慮將這兩個檔案的內容合併。您可以將 GEMINI.md 的所有相關資訊整合到這個 AGENTS.md 檔案中,然後考慮刪除 GEMINI.md,讓 AGENTS.md 成為與 AI 協作的唯一資訊來源。

這樣做可以提高文件的一致性和可維護性。

@Bruce1986
Bruce1986 merged commit eac07f5 into Docs/update-gemini-guidelines Aug 14, 2025
@Bruce1986
Bruce1986 deleted the Bruce1986-patch-1 branch August 14, 2025 15:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant