From 2b2ef941a95ce56fb6b8c5f59aa14b192888036b Mon Sep 17 00:00:00 2001 From: WaterRain <109326062+CATMIAOZHI@users.noreply.github.com> Date: Sun, 30 Aug 2026 05:50:04 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20taste.md=20?= =?UTF-8?q?=E5=8D=8F=E4=BD=9C=E5=81=8F=E5=A5=BD=EF=BC=8CAGENTS.md=20?= =?UTF-8?q?=E8=A6=81=E6=B1=82=E4=BB=BB=E5=8A=A1=E5=89=8D=E5=85=88=E8=AF=BB?= =?UTF-8?q?=E5=8F=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 ++ taste.md | 20 ++++++++++++++++++++ 2 files changed, 22 insertions(+) create mode 100644 taste.md diff --git a/AGENTS.md b/AGENTS.md index 8cd36db..6e0b0d2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,3 +1,5 @@ +任务开始前必须先读取 taste.md(协作偏好),任务全程遵守其中约定,包括:修改后派发独立 subagent 审计(无阻断问题 + 无影响用户体验问题),修复后用同一个 subagent 复审。 + 未经用户允许禁止提交推送 派发子代理任务(独立审计/探索/通用 subagent)时,prompt 中涉及工作区文件的所有路径必须使用完整绝对路径(以工作区根目录为前缀)。子代理没有工作区附着上下文,相对路径会导致其找不到文件或无法执行。 \ No newline at end of file diff --git a/taste.md b/taste.md new file mode 100644 index 0000000..df5e389 --- /dev/null +++ b/taste.md @@ -0,0 +1,20 @@ +# taste.md — 协作偏好 + +本文档记录水晴喵与雨晴喵在本项目开发中的协作偏好。**每个任务开始前必须先读取本文件**,任务全程遵守其中约定。 + +## 审计流程(强制) + +1. **修改后独立审计**:完成代码修改后,必须派发**独立 subagent** 进行审计,确认: + - 无阻断问题(编译失败、逻辑错误、数据流断裂、回归风险) + - 无影响用户体验的问题(UI 展示错误、交互异常、数值显示错误、异常路径处理) +2. **修复后复审**:若审计发现问题并完成修复,必须使用**同一个 subagent**(复用 task_id 续接)再次审计,确认问题已解决,避免引入新版问题。 +3. **审计通过后才可收尾**:提交推送 / 发版 / 宣告完成之前,必须已有审计通过结论。 + +## 其他协作偏好 + +- **实测优先**:解释数据、下结论前先用真实凭据/日志/接口实测验证,不臆断(如字段单位、数值含义、异常原因)。 +- **凭据安全**:用户提供的 cookie、API Key、token 等凭据仅用于实测验证,不写入代码、不提交、不泄露。 +- **未经用户允许禁止提交推送**(见 AGENTS.md)。 +- **路径规范**:派发 subagent 时,prompt 中所有工作区文件路径必须使用完整绝对路径(以工作区根目录为前缀),子代理没有工作区附着上下文。 +- **改前理解**:修改任何文件前先理解相关代码及上下文,遵循项目既有惯例,不搞发明创造。 +- **版本发布惯例**:版本 bump 独立 commit(`release: bump to vX.Y.Z`),轻量 tag 触发自动 Release。 \ No newline at end of file