From 2cdef278aaf648604f84350045dc859b98e01d3f Mon Sep 17 00:00:00 2001 From: Tevin <tingquanren@163.com> Date: Tue, 25 Mar 2025 09:45:58 +0800 Subject: [PATCH] 完成文章 《前端工作共识》 --- _cursor.ai/工作共识.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++---------- 1 files changed, 46 insertions(+), 10 deletions(-) diff --git "a/_cursor.ai/\345\267\245\344\275\234\345\205\261\350\257\206.md" "b/_cursor.ai/\345\267\245\344\275\234\345\205\261\350\257\206.md" index e4e4112..f0135bf 100644 --- "a/_cursor.ai/\345\267\245\344\275\234\345\205\261\350\257\206.md" +++ "b/_cursor.ai/\345\267\245\344\275\234\345\205\261\350\257\206.md" @@ -2,7 +2,7 @@ 尽管我们来自五湖四海，有着各自不同的编码习惯，但现在我们聚集在一起组成了一个团队。为了使团队合作更加流畅，减少沟通成本和内耗，我们需要在以下几个方面达成共识。 -## 1 代码首先是给人读的，其次才是给机器运行 +## 1. 代码首先是给人读的，其次才是给机器运行 团队开发与个人开发最大的区别在于：你身处一个团队中，大家需要相互配合。因此，**让代码容易阅读是你应尽的责任**。 @@ -23,7 +23,7 @@ 1. 做无关模块开发时可以快速跳过不相关代码 2. 做相关模块开发时一眼就能确定要查看的代码 -同时，让实体名词承担功能表述的作用，能让代码维护更依赖阅读而不是记忆，极大减轻记忆负担。 +同时，让实体名词承担功能表述的作用，能让代码维护更依赖阅读而不是记忆，**极大减轻记忆负担** ### 1.2 设计良好的模块与分层结构 @@ -51,29 +51,30 @@ 这不仅减少了代码冗余，还提高了开发效率和代码质量 -## 2 思考先行，开发随后 +## 2. 思考先行，开发随后 ### 2.1 理解清楚需求再动手 由于我们的需求文档通常由老板和总监编写，没有专职人员完善需求细节，因此某些需求描述可能比较模糊 -这种情况下，如果对业务理解不深，很容易导致开发的功能与实际需求不一致，最终需要重做 +这种情况下，如果对业务理解不深，很容易导致开发的功能与实际需求不一致，最终导致需要推倒重来 因此，我们需要在开发过程中不断积累对业务的理解，至少要达到能发现需求歧义的程度 -有歧义是正常的——老板和总监对业务太熟悉了，往往会自然而然地认为某些理解是理所当然的； -而对业务不熟悉的人，从需求文字字面出发，确实可能产生不同理解 +有歧义是正常的，老板和总监对业务太熟悉了，往往会自然而然地认为某些理解是理所当然的 +而对业务不熟悉的人，从需求文字字面出发，从而可能产生不同理解 发现歧义时，请及时咨询我或旭诚，问清楚具体要求，一定要完全理解需求后再开始开发 ### 2.2 设计清晰方案再动手 -除了业务需求，在开发前我还应该梳理清楚技术形式、模块拆分和实现方式，以最简洁的方案实现需求，切忌盲目开工，为求速度而书写毫无章法的代码 +除了业务需求，在开发前还应该梳理清楚技术形式、模块拆分和实现方式，以最简洁的方案实现需求 +切忌盲目开工，为求速度而书写毫无章法的代码 -如果不重视工程质量，因为前端代码过于灵活，一段时间后代码混乱到无法维护了，就被迫需要重构，我们应该避免这样的事情发生 +如果不重视工程质量，因为前端代码过于灵活，一段时间后代码混乱到无法维护了，就被迫需要重构，我们应该避免这种事情发生 -只关注结果产量而不重视工程质量，这种代码是会被要求返工重写的 +只关注结果产量而不重视工程质量，这种代码在代码审查中一旦发现，就会被要求返工重写 -## 3 用户体验是工作的一部分 +## 3. 用户体验是工作的一部分 用户体验是我们前端开发者需要主动思考的问题，这是我们工作的重要组成部分 @@ -100,3 +101,38 @@ 这种复杂性对用户是完全透明的 +## 4. 拥抱 AI + +### 4.1 价值重塑 + +当今世界正在被 AI 技术逐步重构，在这场技术变革浪潮中，提示词工程师已成为不可或缺的关键角色 + +这并不意味着我们过去学习的技术知识变得无用，提示词工程师需要承担起工程建设的全部责任 +当项目出现问题时，责任不在于 AI 而在指导 AI 的工程师，这正是工程师价值的核心所在 + +同时，我们开发的产品是为人服务的 +无论 Agent 多么智能，它都无法和真实的人那样体验产品，因此我们需要清晰地指导 AI 完成什么任务，告诉它做好了没，确保产品能够满足人的需求 + +### 4.2 开发流程中的应用 + +在代码生成方面，AI 能快速生成组件、功能、工作流程，但核心业务逻辑仍需人工审核 + +代码质量审查上，AI 能检查潜在bug、发现安全隐患、提示缺失注释，全方位提升代码质量标准 + +文档编写与维护中，AI 协助编写各类文档，保证完整性和一致性，减轻维护负担 + +### 4.3 辅助开发的基本原则 + +首先，我们需要了解 AI 的能力边界 +AI 工具虽然强大但并非万能，我们需要理解它的优势和局限性。它在代码生成、问题诊断、知识获取等方面可以发挥巨大作用，但创造性设计、用户体验把控和业务理解仍然需要人类的专业判断 + +其次，我们应该提高提示词工程能力 +良好的提示词能让 AI 输出更准确、更符合项目需求的结果。学会如何结构化描述问题、提供足够上下文、明确说明需求和约束，是高效使用 AI 的关键技能 + +最后，我们必须保持技术掌控和结果的主导权 +AI 只是工具而非替代品。对生成的代码需要保持审查和理解，确保它符合我们的架构和规范，保持对代码的掌控力和理解力是开发者的基本要求 + +### 4.4 调整心态，面向未来 + +拥抱 AI 不是简单地使用工具，而是重新思考我们的工作方式和价值定位 +在这个转变过程中，持续学习、开放心态和职业成长将是我们适应新时代的关键要素 -- Gitblit v1.9.1