You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@opendal.apache.org by xu...@apache.org on 2026/09/09 06:49:55 UTC
(opendal) branch main updated: docs: specify AI usage configuration disclosure (#8268)
This is an automated email from the ASF dual-hosted git repository.
Xuanwo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/opendal.git
The following commit(s) were added to refs/heads/main by this push:
new ccac01df21 docs: specify AI usage configuration disclosure (#8268)
ccac01df21 is described below
commit ccac01df216167e984bccd2650d498d7433504cc
Author: Xuanwo <gi...@xuanwo.io>
AuthorDate: Wed Sep 9 14:49:48 2026 +0800
docs: specify AI usage configuration disclosure (#8268)
---
.github/pull_request_template.md | 12 +++++++++---
AGENTS.md | 6 ++++--
CONTRIBUTING.md | 16 ++++++++++++++++
3 files changed, 29 insertions(+), 5 deletions(-)
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index c77a29dea1..af5cc46b4d 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -33,9 +33,15 @@ If there are any breaking changes to public APIs, please add the `breaking-chang
# AI Usage Statement
<!--
-If AI materially assisted this PR, briefly describe its role and disclose any
-assumptions or unknowns that affect review. Do not include routine command output
-or repeat information provided elsewhere.
+If AI materially assisted this PR, list each harness/model/effort combination
+that materially contributed, and briefly describe its role:
+
+- Harness: Application or agent framework used to run the model.
+- Model: Model name or identifier shown by the harness, with version if available.
+- Effort: Reasoning effort setting as named by the harness.
+- Role: AI's contribution and any assumptions or unknowns that affect review.
+
+Do not include routine command output or repeat information provided elsewhere.
The author remains responsible for every submitted claim and change. If AI did
not materially assist this PR, write "None".
diff --git a/AGENTS.md b/AGENTS.md
index d310c03dde..75da164abf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,8 +26,10 @@ policy.
maintainer has explicitly accepted it as a hardening or maintenance goal.
- A test against a fabricated response can verify implementation behavior, but
it does not establish that the change solves a real-world problem.
-- In a Pull Request, briefly disclose AI's material role and any assumptions or
- unknowns that affect review. Do not repeat routine validation output.
+- In a Pull Request, disclose each materially contributing harness, model, and
+ reasoning effort setting, along with AI's role and any assumptions or unknowns
+ that affect review. Follow the AI Usage Statement requirements in
+ CONTRIBUTING.md. Do not repeat routine validation output.
The human contributor remains responsible for every submitted claim and change.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8594f4c2c4..90d9adf554 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -53,6 +53,22 @@ guides the work and remains accountable for it.
The contributor, not the AI tool, is responsible for the accuracy, relevance,
and quality of every submission.
+### AI Usage Statement
+
+If AI materially assisted a Pull Request, include the following in its AI Usage
+Statement:
+
+- **Harness:** The application or agent framework used to run the model.
+- **Model:** The model name or identifier shown by the harness, including its
+ version when available.
+- **Effort:** The reasoning effort setting used, as named by the harness.
+- **Role:** How AI contributed, and any assumptions or unknowns that affect
+ review.
+
+List each harness, model, and effort combination that materially contributed.
+Keep the statement brief and omit routine command output or information already
+provided elsewhere. If AI did not materially assist the PR, write `None`.
+
### Bug Reports
OpenDAL welcomes the use of AI tools to analyze source code and find bugs. A