npx skills add https://github.com/mcollina/skills --skill init在创建或更新仓库的 AGENTS.md 文件时使用此技能。
尤其在以下情况使用:
AGENTS.md 文件冗长、通用或已过时将 AGENTS.md 视为 一份关于不易发现的“地雷”和工作流程陷阱的动态清单,而非代码库概述。
在添加任何内容前,先问:
智能体通过阅读仓库(
README、代码、配置、脚本、目录树)能发现这一点吗?
AGENTS.md 中。仅包含符合以下条件的指引:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
典型示例:
uv 而非 pip)--no-cache 运行)不要包含:
倾向于简短、高信息量的章节,例如:
范围与路由(哪些区域需要单独的/模块本地的 AGENTS 文件)不易发现的命令“地雷”/请勿触碰区域特定任务的约束对于大型仓库,建议在相关模块附近使用 分层级的 AGENTS.md 文件,而不是一个单一的根文件。
AGENTS.mdREADME.mdPROJECT.md(如果存在).cursor/rules/ 或 .cursorrules).github/copilot-instructions.md)GEMINI.md如果 AGENTS.md 已存在,请逐步改进它,而不是盲目替换。
AGENTS.md 是临时指引,而非永久配置。
当反复出现问题时:
对于 AGENTS.md 中的每一行,请验证:
删除任何未通过上述任何一项检查的内容。
每周安装量
194
代码仓库
GitHub 星标
1.5K
首次出现
2026年2月20日
安全审计
已安装于
codex189
opencode189
github-copilot188
cursor187
gemini-cli186
kimi-cli185
Use this skill when creating or updating AGENTS.md for a repository.
Use it especially when:
AGENTS.md is long, generic, or staleTreat AGENTS.md as a living list of non-discoverable landmines and workflow gotchas , not a codebase overview.
Before adding any line, ask:
Can an agent discover this by reading the repo (
README, code, config, scripts, directory tree)?
AGENTS.md.Include only guidance that is:
Typical examples:
uv instead of pip)--no-cache due to fixture behavior)Do not include:
Prefer short, high-signal sections such as:
Scope & routing (which areas need separate/module-local AGENTS files)Non-discoverable commandsLandmines / do-not-touch areasTask-specific constraintsFor large repos, recommend hierarchical AGENTS.md files near relevant modules instead of one monolithic root file.
AGENTS.mdREADME.mdPROJECT.md (if present).cursor/rules/ or .cursorrules).github/copilot-instructions.md)GEMINI.mdIf AGENTS.md exists, improve it incrementally instead of replacing it blindly.
AGENTS.md is temporary guidance, not permanent configuration.
When recurring issues appear:
For each line in AGENTS.md, verify:
Delete any line that fails one of these checks.
Weekly Installs
194
Repository
GitHub Stars
1.5K
First Seen
Feb 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex189
opencode189
github-copilot188
cursor187
gemini-cli186
kimi-cli185
代码库搜索技能指南:精准查找函数、追踪依赖、理解架构与定位错误
10,900 周安装