GenAI/LLM/AI Agent Guideline

[UTsweetyfish]

(not a rfc yet)

本 issue 的写作并未使用 GenAI/LLM 工具

现状

Co-Authored-By 了 Claude Opus 4.6:

• linuxdeepin/deepin-manual@d62dce7
• feat: verify exported indices consistency after update/pull reprepro#12

部分项目已经将 .claude 加入了 .gitignore:

• feat: enhance security and resource limits linuxdeepin/deepin-diskmanager#187
• chore: enhance service security. linuxdeepin/deepin-log-viewer#429
• feat: Merge from release/1071 linuxdeepin/deepin-diskmanager#186
• build(cmake): refactor Qt version compatibility linuxdeepin/deepin-editor#416
• chore: enhance service security linuxdeepin/deepin-boot-maker#102
• fix: update .gitignore and modify formatDevice function linuxdeepin/dde-device-formatter#35
• fix: Improve ext* filesystem usage display logic linuxdeepin/deepin-diskmanager#158
• build: separate Qt5 and Qt6 build configurations by split debian/control linuxdeepin/dde-cooperation#709
• chore: update version to 6.5.48 linuxdeepin/deepin-reader#240
• build(debian): separate Qt5/Qt6 build configurations for V25/V20 support linuxdeepin/deepin-log-viewer#434
• chore: harden service security linuxdeepin/deepin-devicemanager#588

在 GitHub actions 中使用 opencode-review

• ci: add opencode review workflow for PR comments linuxdeepin/dde-cooperation#707

使用 Claude Code 进行 Code Review

• fix(ComboBox): fix highlight lingering after mouse leaves linuxdeepin/dtkdeclarative#585 (comment)

使用 AI 进行 Code Review

• Sourcery AI
• Copilot

@hudeng-go 在做的使用 AI 来做安全修复，截至目前 230+ (24+ merged): q=is:pr author:deepin-ci-robot label:generated-by-ai

需考虑的问题

1. 贡献者如使用了辅助类工具，贡献者是否应能够完全理解 AI 的改动，是否审阅、测试过（thoroughly understood, reviewed, and tested）
2. 如贡献使用了辅助类工具，贡献者是否应声明使用了辅助类工具，是否应声明提示词与模型？及应如何声明？
3. 辅助类工具的参与度应到哪里？只限于 git 提交？参与到 GitHub 的 conversation 中？由 Agent 自行提 Pull Request？
4. 如何避免或减少幻觉、遗漏、夸大或歪曲？（may suffer from hallucination, omission, exaggeration, or misrepresentation）
5. Code Review 为 AI
6. 是否应必须有人参与其中？（must be a human in the loop）
7. AI 生成内容的许可证问题 (GenAI/LLM/AI Agent Guideline #19 (comment))
8. [TODO]

实现细节

1. git commit 的字段：
   • Co-Authored-By
   • Co-Developed-By
   • Assisted-by
   • Signed-off-by
2. github issue/PR 的信息：
   目前在 deepin-community 我们在 PR 上使用了 label:generated-by-ai
   需考虑: 提测单 / ... (ref: [Deepin Integration]~[v25-Release] fix: Fix CVE-2026-35535 by deepin-ci-robot@deepin-community/sudo by deepin-community-ci-bot[bot] linuxdeepin/developer-center#13041)
3. debian/changelog 的信息：
   由 AI 贡献时，是否应在 debian/changelog 声明？
   完全由 AI 贡献时，debian/changelog 的 author line 该怎么写？
4. [TODO]

可供参考

https://www.eff.org/about/opportunities/volunteer/coding-with-eff
https://www.eff.org/deeplinks/2026/02/effs-policy-llm-assisted-contributions-our-open-source-projects
https://llvm.org/docs/AIToolPolicy.html
https://lwn.net/Articles/1032612/
https://docs.kernel.org/process/generated-content.html

Debian (Draft) - https://lists.debian.org/debian-vote/2026/02/msg00000.html

https://docs.fedoraproject.org/en-US/council/policy/ai-contribution-policy/
https://matplotlib.org/devdocs/devel/contribute.html#restrictions-on-generative-ai-usage

Assisted-by: AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]
Assisted-by: Claude:claude-opus-4.6
Assisted-By: Claude Opus 4.6 (1M context)
Assisted-by: ChatGPTv5
Made-with: Cursor
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

LLM review tool - Sashiko

https://lwn.net/Articles/1063292/
https://lwn.net/Articles/1064830/
https://lwn.net/Articles/1065971/

and more ... [TODO]

[BLumia]

暂时先回复上面其中几项内容的我的观点：

Code Review 为 AI

这点好像完全没有问题？

贡献者是否应声明使用了辅助类工具

如果较多代码以 LLM 生成，我觉得有一定标注的意义，如果比重很少我觉得意义不大。不过无论是否标注，我觉得落实在 review （“是否审阅、测试过”）的意义更大。

是否应声明提示词与模型？

贴模型我觉得没意义，毕竟考虑到目前有的提供商会注水或者降智，相同模型使用不同工具的效果也不同。

贴提示词的意义可能也不是很大，如果一个提交是多次对话产生的话，得贴完整会话才有实际意义，但不太现实。

[UTsweetyfish]

还有 LLM 的版权/许可证问题（一个背景是 chardet 使用 LLM 重写&改授权）

AI generated Code or Rewrites violate FOSS-Licences. Talk at ... YouTube · Anwalt Jun

当然，elephant in the room

[hudeng-go]

linuxdeepin/.github#783 linuxdeepin 组织下的项目添加coauthor中包含ai的拦截监测。

[UTsweetyfish]

The future of AI in Ubuntu
https://discourse.ubuntu.com/t/the-future-of-ai-in-ubuntu/81130

[qaqland]

Refs: linuxdeepin/dde-application-manager#277 (comment)

[UTsweetyfish]

linuxdeepin/.github#773: docs: Add organization-wide GitHub Copilot instructions

[UTsweetyfish]

2026-05-13 TC 例会 minutes: https://github.com/deepin-community/SIG/blob/master/TC/Meeting%20Minutes/2026-05.md