Skip to content

docs: refine agent guidelines - #924

Open
YunXi-Aurora wants to merge 2 commits into
AAswordman:devfrom
YunXi-Aurora:docs/refine-agent-guidelines
Open

YunXi-Aurora wants to merge 2 commits into
AAswordman:devfrom
YunXi-Aurora:docs/refine-agent-guidelines

Conversation

@YunXi-Aurora

@YunXi-Aurora YunXi-Aurora commented Aug 11, 2026 •

Copy link
Copy Markdown
Contributor

变更背景、动机和改动范围

细化 AGENTS.md 中的执行约束,使回退逻辑禁令与用户愤怒时的处理步骤更明确、可执行。

主要改动点:

  • 将分散的回退/兜底禁令合并为一条紧凑、加粗强调的规则,明确列举禁止字眼
  • 用户愤怒处理从一句话拆为有序步骤(停下工作 -> 道歉反思安抚 -> 确认需求 -> 实现)
  • 去除冗余空行,微调标点与措辞,使文意更连贯

仅修改 AGENTS.md 一个文件,不涉及其他文件。

关联 Issue

N/A。维护性文档更新。

兼容性、数据、配置、性能和安全影响

无。仅更新 Agent 执行指南,不影响应用运行时行为。

验证方式

未运行构建或测试:改动仅涉及 Markdown 指南,且 AGENTS.md 要求未获明确要求时不执行编译、构建或测试。已核对变更范围仅为 AGENTS.md(1 个文件,+18 / -29)。

提交前检查

  • PR 聚焦于单一文档改动
  • 未包含密钥、Token、私有 URL 或本地路径
  • 已说明不适用的验证项

@YunXi-Aurora YunXi-Aurora reopened this Sep 21, 2026
@YunXi-Aurora
YunXi-Aurora force-pushed the docs/refine-agent-guidelines branch from 02d6042 to d03fb0c Compare September 21, 2026 04:35
@YunXi-Aurora
YunXi-Aurora changed the base branch from main to dev September 21, 2026 05:37
@CATMIAOZHI
CATMIAOZHI self-requested a review September 25, 2026 07:28

@CATMIAOZHI CATMIAOZHI left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

审计结论:✅ 批准合并

改动(1 个文件,+18/−29):细化 AGENTS.md 中的 Agent 执行约束——回退/兜底禁令合并为一条加粗规则并明确列举禁止字眼;用户愤怒处理从一句话拆为有序步骤(停下工作 → 道歉反思安抚 → 确认需求 → 实现);微调标点措辞,去除冗余空行。

通过的检查:

  • base 为 dev ✓;纯 Markdown 文档改动,不涉及应用代码,无运行时行为影响
  • 改动语义与原文一致:方案更换规则(已发布版本做向前兼容/未发布彻底清理)的语义未变,仅措辞收紧;回退禁令的禁止字眼清单与原版对应;用户愤怒处理四步与原两句含义一致
  • 路径引用(docs\doc-src\before_docing.md、docs\TODO\README.md)为既有写法,本次未引入新引用
  • PR 描述与 diff 一致;提交前检查已说明无密钥、无验证项

问题:

  1. [P3] 文件末尾缺少换行符(\ No newline at end of file),顺手补一下即可。

由 水晴喵的muse 审计

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.

3 participants