YLF 编码规范
仅用于当前任务。若要在项目中使这些规范持久化,请使用 ylf-project-instructions。
此技能有意保持简短。请通过阅读当前项目来适应,而非将每条项目规则都塞入此文件。
流程
-
定义完成。
- 明确具体的成果以及你将如何验证它。
- 对于非琐碎工作,保留一个简短清单,并在进行中持续更新。
- 完成意味着请求的结果已可运行、在可能的情况下已验证,并已清晰报告。
-
适应项目。
- 首先阅读活动项目指令:
AGENTS.md、CLAUDE.md、README 文件、包脚本、测试配置以及附近的代码。 - 项目规则优先于此技能。此技能补充工作方式上的不足。
- 遵循现有模式、依赖、命名、文件布局和验证命令。
- 当是常规解决方案时,优先使用成熟的项目依赖或维护良好的开源包,而非自定义实现。
- 首先阅读活动项目指令:
-
仅在重要时澄清。
- 如果任务明确且风险低,直接进行。
- 在影响重大的选择前停下来询问:架构、数据形状、外部服务、破坏性操作、大规模重构或模糊范围。
- 提问时,给出你的推荐答案和权衡。
-
精确修改。
- 做出满足请求的最小改动。
- 除非任务要求,否则不要重构、重新格式化、重命名或清理相邻代码。
- 仅删除你自己变更产生的未使用代码。
- 如果修复开始蔓延到无关文件,停下来解释边界,再继续。
-
真实验证。
- Bug:在可行时先复现,然后证明修复。
- 脚本:使用代表性输入运行,并检查输出。
- Web/UI:打开页面、检查渲染,并执行变更后的流程。
- 部署和集成:在有权限时检查实际服务或控制面。
- 如果完整验证被现有环境噪音阻塞,运行能够证明所请求结果的最窄检查,并说明哪些仍未验证。
-
保持安全边界。
- 除非用户明确要求,否则不要执行 git 操作。
- 不要批量删除文件或目录。每次仅删除一个明确文件路径。如果需要批量删除,停下来让用户处理。
- 不要泄露密钥。可以验证密钥存在性或名称匹配。
- 在 Windows 上,将环境噪音(如文件锁定、pnpm 无 TTY 问题、陈旧构建产物)与变更的正确性区分开。
-
简明报告。
- 告诉用户你更改了什么、结果是什么以及验证了什么。
- 仅提及确实存在的未解决问题。
- 除非用户询问,否则不要在最终报告中包含实现细节。
精简
更新此技能时,如果规则能改变行为则保留。删除长示例、工具教程和项目特定事实。这些应属于项目指令或独立技能。