skills/skills/init-workspace/assets/AGENTS.template.md

<工作区名> Workspace Guide

这个工作区是 <谁> 进行 <项目> 工作时使用的个人执行目录。

Quick Context

• <用户> 主要负责 <模块> 相关内容。
• 任务模块不明确时先确认或结合最近上下文判断,不要直接假设。
• <上游库> 也是 <用户> 维护的库。问题疑似来自这些库时,先说明判断并询问是否去上游排查,不在业务仓库堆绕行补丁。

Communication

• 默认中文;路径、命令、代码标识符、技术术语保留原文。
• 描述工作时直接说动作和结果:做了什么、改了哪个文件、行为变化是什么;每个说法都能对应到具体的文件、命令或数据。
• 结论先行;有取舍、风险或需要证据链时再补原因。
• 如无特殊说明或指定,"文档"指工作区文档(docs/ 与 AGENTS.md)。

Workspace Docs

• 处理需求、方案、review 或恢复上下文时,优先查看 docs/README.md、docs/prd/、docs/plans/、docs/guides/、docs/sop/。
• 目录边界不用卡得太死,重点是快速找到信息并继续推进。

Shell on Windows

• 临时文件放系统临时目录下的任务独立子目录,不在仓库里散落。
• 路径含空格或中文时加引号。
• Git Bash/MSYS2 下抑制输出用 /dev/null;> nul 会创建名为 nul 的真实文件,发现即删。

Commits

• commit message 不加 Co-Authored-By 等 AI 署名 trailer,不加会话链接(如 claude.ai/code 的 session URL)。

Design Check

• 实现或 review 中发现修复在叠加条件、状态同步、调用方绕行或特殊分支(patch-on-patch)时,回到模块边界、数据流、调用关系重新看问题,说明更干净的方向。

Code Review

• findings 按 P0 到 Px 排序,P0.1 式细分可用。
• 定级前 double-check;缺复现证据的低概率问题降级并标注不确定性。
• 根据 diff、代码、测试和工作区文档反推修改意图或对应 PRD;推测标注为推测。
• 提到路径、函数名时顺带说明这块是做什么的。
• review 结论输出前用 $think-twice 做自包含、证据和表达检查。

Output Quality

• 交付需要独立成立的文本(handoff、PR/issue 正文、文档)前,用 $think-twice。

Coding Rules

• 实现、修复或 review 代码前,先完整读取 @CODINGRULES.md 并遵循;宿主已自动加载其内容时不必重复读取。纯文档改动不适用。

Structure

• <repo>/: 源码仓库
• pkgs/: 参考库,仅作补充上下文
• docs/: 工作区文档、PRD、计划、SOP 与临时记录
• scripts/: 工作区脚本