agents-md - SKILL-北京尧图网络

name: agents-mddescription: This skill should be used when the user asks to “create AGENTS.md”, “update AGENTS.md”, “maintain agent docs”, “set up CLAUDE.md”, or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.risk: criticalsource: community维护 AGENTS.mdAGENTS.md 是面向代理的权威文档。保持简洁——代理足够能干不需要手把手的指导。目标是少于 60 行绝不超过 100 行。随着文档长度增加执行指令的质量会下降。何时使用用户请求创建、更新或审计AGENTS.md或CLAUDE.md。该项目需要从实际工具链和仓库布局中提炼出的简明、高信号的代理指令。现有的代理文档太长、重复或者偏离了实际项目的规范。文件设置在项目根目录创建AGENTS.md创建符号链接ln -s AGENTS.md CLAUDE.md写作前分析项目以了解哪些内容属于该文件包管理器— 检查锁文件pnpm-lock.yaml、yarn.lock、package-lock.json、uv.lock、poetry.lockLinter/格式化程序配置— 查找.eslintrc、biome.json、ruff.toml、.prettierrc等。不要在 AGENTS.md 中重复这些内容CI/构建命令— 检查Makefile、package.json脚本以及 CI 配置中的标准命令Monorepo 指示器— 检查pnpm-workspace.yaml、nx.json、Cargo workspace 或子目录中的package.json文件现有的约定— 检查现有的 CONTRIBUTING.md、docs/ 或 README 模板写作规则标题项目符号— 无段落代码块— 用于命令和模板仅作参考不要嵌入— 指向现有文档“有关设置请参阅CONTRIBUTING.md” 或 “遵循src/api/routes/中的模式”无废话— 无介绍、结论或客套话信任能力— 省略明显的上下文优先使用文件范围的命令— 每个文件的测试/代码检查/类型检查命令优于全项目构建不要重复使用代码检查工具— 代码风格存在于代码检查工具配置中而不是 AGENTS.md必填部分软件包管理器仅使用哪个工具和快捷键## Package Manager Use **pnpm**: pnpm install, pnpm dev, pnpm test文件范围命令逐文件命令比完整项目构建更快、更便宜。可用时请始终包括## File-Scoped Commands | Task | Command | |------|---------| | Typecheck | pnpm tsc --noEmit path/to/file.ts | | Lint | pnpm eslint path/to/file.ts | | Test | pnpm jest path/to/file.test.ts |提交归属始终包含此部分。代理应使用他们自己的身份## Commit Attribution AI commits MUST include:联合作者代理模型的名称和署名栏Example: Co-Authored-By: Claude Sonnet 4 noreplyexample.com关键惯例项目特定模式代理必须遵循。保持简短。可选部分仅在真正需要时添加API 路由模式显示模板不解释命令行界面命令表格格式文件命名规范项目结构提示指向关键文件标记需避免的遗留代码单一代码库覆盖子目录AGENTS.md文件覆盖根目录反模式省略这些“欢迎来到……” 或 “本文件说明……”“你应该……”或“记得……”Lint器/格式化器规则已在配置文件中.eslintrc、biome.json、ruff.toml列出已安装的技能或插件代理会自动发现这些当存在文件范围的替代项时完整的全项目构建命令明显的指示“运行测试”“编写干净的代码”解释原因只说是什么长篇散文段落示例结构# Agent Instructions ## Package Manager Use **pnpm**: pnpm install, pnpm dev ## Commit Attribution AI commits MUST include:联合作者代理模型的名称和署名## File-Scoped Commands | Task | Command | |------|---------| | Typecheck | pnpm tsc --noEmit path/to/file.ts | | Lint | pnpm eslint path/to/file.ts | | Test | pnpm jest path/to/file.test.ts | ## API Routes [Template code block] ## CLI | Command | Description | |---------|-------------| | pnpm cli sync | Sync data |限制仅当任务明确符合上述描述的范围时才使用此技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少所需的输入、权限、安全界限或成功标准请停下来并要求澄清。

agents-md - SKILL

相关推荐

agents-generator - decision-matrix

agenttrace-session-audit - SKILL

ai-agent-development - SKILL

更多资讯

嵌入式驱动开发实战：从寄存器操作到DMA调试的完整经验总结

时序路径分析核心框架：从STA原理到违例修复实战

智能制造生产优化的5大落地难点：数据断层、多目标冲突与人机协同

采样间隔1秒一天86KB？GOT2000数据记录容量配置全解析

Loop 开源窗口管理工具：鼠标手势与快捷键提升 macOS 多窗口效率

如何降低AI检测率？让AI写作更有“人味儿”的实用技巧

今日更新

Verilog实现FPGA密码锁：矩阵键盘与状态机设计实战

数据服务监控运维实战：从指标体系到告警治理与故障排查

FreeRTOS任务通知实战详解：内核原理、API与避坑指南

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？