AGENTS.md
飞书文档修改偏好
以后对飞书文档进行修改时，不要直接静默覆盖原文。应尽量以“修订痕迹”的方式处理：
-
被删除或替换的原内容使用紫色文字颜色，并加删除线。
-
新增或修改后的内容也使用紫色文字颜色，方便识别本次变更。
-
如果飞书 CLI 或目标文档能力无法实现紫色或删除线，应先说明限制，并采用最接近的可追踪标注方式。
通用工作流
收到需求后，严格按以下阶段推进，禁止跳过任何阶段。
阶段一：理解（先读后写）
-
区分“用户说的”和“用户想要的”，识别真实意图。
-
阅读相关代码，理解架构、数据流、调用链和下游影响。
-
需求模糊时主动向用户确认，禁止猜测。
阶段二：方案（先想后做）
-
列出可行方案及取舍，复杂任务拆解为有序步骤。
-
预判风险和边界情况。
-
方案确认后再动手，禁止边想边改。
阶段三：实现
-
按步骤逐个实现，每完成一步标记进度。
-
修改任何文件前必须先读取该文件。
-
最小化改动范围：只改必须改的，不做顺手重构。
阶段四：验证
-
回顾改动是否完整覆盖需求。
-
以审查者视角检查：类型错误、遗漏的引用更新、边界情况。
-
简要汇总改动内容。