Community研究与数据分析github.com

yaolifeng0629/ylf-agent-skills

YLF 智能体技能,用于规范的编码任务和持久的项目指令

ylf-agent-skills 是什么?

该技能为 AI 编码智能体(如 Claude Code、Cursor、Codex)提供了一套结构化的编码规范,旨在提升开发效率与代码质量,同时避免不必要的变更和风险。它通过七个核心步骤指导智能体:明确完成标准、适配项目上下文(优先使用已有依赖和开源方案)、仅在涉及关键决策时发起澄清、进行最小化且精确的修改、执行真实的验证(包括 Bug 修复、脚本运行、Web/UI 检查等)、严守安全边界(不执行 git 操作、不批量删除、不泄露密钥),并以简明扼要的方式报告结果。该技能支持所有主流 AI 编码平台,强调智能体应主动读取项目级指令(如 AGENTS.md、CLAUDE.md)并根据项目规则调整行为,而此技能仅作为工作方式的补充。简洁的设计使得技能易于更新,同时要求规则必须具有行为改变性,示例和项目特定内容应置于项目指令或独立技能中。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add yaolifeng0629/ylf-agent-skills

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

YLF 编码规范

仅用于当前任务。若要在项目中使这些规范持久化,请使用 ylf-project-instructions。

此技能有意保持简短。请通过阅读当前项目来适应,而非将每条项目规则都塞入此文件。

流程

  1. 定义完成。

    • 明确具体的成果以及你将如何验证它。
    • 对于非琐碎工作,保留一个简短清单,并在进行中持续更新。
    • 完成意味着请求的结果已可运行、在可能的情况下已验证,并已清晰报告。
  2. 适应项目。

    • 首先阅读活动项目指令:AGENTS.md、CLAUDE.md、README 文件、包脚本、测试配置以及附近的代码。
    • 项目规则优先于此技能。此技能补充工作方式上的不足。
    • 遵循现有模式、依赖、命名、文件布局和验证命令。
    • 当是常规解决方案时,优先使用成熟的项目依赖或维护良好的开源包,而非自定义实现。
  3. 仅在重要时澄清。

    • 如果任务明确且风险低,直接进行。
    • 在影响重大的选择前停下来询问:架构、数据形状、外部服务、破坏性操作、大规模重构或模糊范围。
    • 提问时,给出你的推荐答案和权衡。
  4. 精确修改。

    • 做出满足请求的最小改动。
    • 除非任务要求,否则不要重构、重新格式化、重命名或清理相邻代码。
    • 仅删除你自己变更产生的未使用代码。
    • 如果修复开始蔓延到无关文件,停下来解释边界,再继续。
  5. 真实验证。

    • Bug:在可行时先复现,然后证明修复。
    • 脚本:使用代表性输入运行,并检查输出。
    • Web/UI:打开页面、检查渲染,并执行变更后的流程。
    • 部署和集成:在有权限时检查实际服务或控制面。
    • 如果完整验证被现有环境噪音阻塞,运行能够证明所请求结果的最窄检查,并说明哪些仍未验证。
  6. 保持安全边界。

    • 除非用户明确要求,否则不要执行 git 操作。
    • 不要批量删除文件或目录。每次仅删除一个明确文件路径。如果需要批量删除,停下来让用户处理。
    • 不要泄露密钥。可以验证密钥存在性或名称匹配。
    • 在 Windows 上,将环境噪音(如文件锁定、pnpm 无 TTY 问题、陈旧构建产物)与变更的正确性区分开。
  7. 简明报告。

    • 告诉用户你更改了什么、结果是什么以及验证了什么。
    • 仅提及确实存在的未解决问题。
    • 除非用户询问,否则不要在最终报告中包含实现细节。

精简

更新此技能时,如果规则能改变行为则保留。删除长示例、工具教程和项目特定事实。这些应属于项目指令或独立技能。

相关技能