docs: refine agent guidelines - #924
Open
YunXi-Aurora wants to merge 2 commits into
Open
YunXi-Aurora wants to merge 2 commits into
YunXi-Aurora wants to merge 2 commits into
Conversation
chore(release): sync dev to main for 1.12.2
YunXi-Aurora
force-pushed
the
docs/refine-agent-guidelines
branch
from
September 21, 2026 04:35
02d6042 to
d03fb0c
Compare
CATMIAOZHI
self-requested a review
September 25, 2026 07:28
CATMIAOZHI
approved these changes
Sep 25, 2026
CATMIAOZHI
left a comment
Collaborator
There was a problem hiding this comment.
审计结论:✅ 批准合并
改动(1 个文件,+18/−29):细化 AGENTS.md 中的 Agent 执行约束——回退/兜底禁令合并为一条加粗规则并明确列举禁止字眼;用户愤怒处理从一句话拆为有序步骤(停下工作 → 道歉反思安抚 → 确认需求 → 实现);微调标点措辞,去除冗余空行。
通过的检查:
- base 为
dev✓;纯 Markdown 文档改动,不涉及应用代码,无运行时行为影响 - 改动语义与原文一致:方案更换规则(已发布版本做向前兼容/未发布彻底清理)的语义未变,仅措辞收紧;回退禁令的禁止字眼清单与原版对应;用户愤怒处理四步与原两句含义一致
- 路径引用(
docs\doc-src\before_docing.md、docs\TODO\README.md)为既有写法,本次未引入新引用 - PR 描述与 diff 一致;提交前检查已说明无密钥、无验证项
问题:
- [P3] 文件末尾缺少换行符(
\ No newline at end of file),顺手补一下即可。
由 水晴喵的muse 审计
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
变更背景、动机和改动范围
细化
AGENTS.md中的执行约束,使回退逻辑禁令与用户愤怒时的处理步骤更明确、可执行。主要改动点:
仅修改
AGENTS.md一个文件,不涉及其他文件。关联 Issue
N/A。维护性文档更新。
兼容性、数据、配置、性能和安全影响
无。仅更新 Agent 执行指南,不影响应用运行时行为。
验证方式
未运行构建或测试:改动仅涉及 Markdown 指南,且
AGENTS.md要求未获明确要求时不执行编译、构建或测试。已核对变更范围仅为AGENTS.md(1 个文件,+18 / -29)。提交前检查