代理
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
Migrate existing agent documentation files to the standardized AGENTS.md format. Default to creating a compact single file; ask about references folder only for complex projects.
## Load Context
Load the agents-md skill for format guidance:
```
Use Skill tool with skill="agd:agents-md"
```
Provides: sections, structure, symlink patterns, best practices
## Migration Sources
Detect and migrate from common agent documentation files:
| Source File | Detection | Migration Strategy |
|-------------|-----------|-------------------|
| `AGENT.md` | Single-file predecessor | Convert to AGENTS.md, ensure all sections covered |
| `.cursorrules` | Cursor IDE rules | Extract rules, convert to AGENTS.md sections |
| `.windsurfrules` | Windsurf IDE rules | Extract rules, convert to AGENTS.md sections |
| `CLAUDE.md` | Claude Code instructions | Merge with AGENTS.md or convert |
| `contributing.md` | Developer guidelines | Extract relevant sections for AGENTS.md |
## Process
1. **Detect source files**:
```bash
ls -la | grep -E '(AGENT\.md|\.cursorrules|\.windsurfrules|CLAUDE\.md)'
```
2. **If no source specified, auto-detect**:
- Priority: AGENT.md > .cursorrules > .windsurfrules > CLAUDE.md
- Prompt user if multiple files found
3. **Read and analyze source file**:
- Identify existing sections
- Extract commands, conventions, and guidelines
- Note any missing recommended sections
4. **Transform to compact AGENTS.md format**:
- Map existing content to recommended sections
- Add missing sections based on project analysis
- **Keep core AGENTS.md lean and actionable** (target: 50-80 lines)
- Focus on essential commands and conventions
- **Use relative paths** for references (e.g., `./docs/agents/testing.md`)
- **For monorepos**: Add relative path references to sibling packages (e.g., `../api/AGENTS.md`)
5. **Create the new AGENTS.md**:
- Write to ./AGENTS.md (or specified path)
- Do not overwrite existing AGENTS.md without confirmation
6. **Ask about references folder** using AskUserQuestion (only if source was verbose or user wants detailed docs):
```
questions: [
{
"question": "Would you like me to create a references folder for the detailed content from the original file?",
"header": "References",
"options": [
{
"label": "No, single file is enough",
"description": "Keep AGENTS.md as a simple, compact file. Recommended for most projects."
},
{
"label": "Yes, create docs/agents/",
"description": "Create references folder and move detailed content there."
},
{
"label": "Yes, use custom path",
"description": "Specify a custom path for the references folder."
}
]
}
]
```
**Only ask if**:
- Original source file was verbose (>100 lines)
- User explicitly wants to preserve all detailed content
- Project has complex patterns needing documentation
7. **Create reference files** (if user chose yes):
- Create detailed docs in references folder (e.g., docs/agents/)
- Reference them from AGENTS.md
8. **Validate the migrated file**:
- Check all commands are executable
- Ensure all recommended sections present
- Confirm no content lost in migration
- Verify file is compact (under 100 lines)
9. **Handle original file**:
Call AskUserQuestion:
```json
{
"questions": [{
"question": "What should I do with the original source file?",
"header": "Original file",
"options": [
{"label": "Create symlink", "description": "Run ln -sf AGENTS.md <original-file> so it points to the new AGENTS.md."},
{"label": "Keep as-is", "description": "Leave the original file unchanged alongside AGENTS.md."},
{"label": "Delete original", "description": "Remove the original file after migration is complete."}
]
}]
}
```
- "Create symlink" → `ln -sf AGENTS.md <original-file>`
- "Keep as-is" → no action
- "Delete original" → `rm <original-file>`
10. **Ask about additional symlinks**:
Call AskUserQuestion:
```json
{
"questions": [{
"question": "Would you like me to create symlinks for other AI agents?",
"header": "Symlinks",
"options": [
{"label": "No symlinks", "description": "Keep AGENTS.md as the only file."},
{"label": "Create CLAUDE.md", "description": "Symlink CLAUDE.md → AGENTS.md for Claude Code compatibility."},
{"label": "Create all symlinks", "description": "Create CLAUDE.md, .cursorrules, and .windsurfrules all pointing to AGENTS.md."}
]
}]
}
```
- "No symlinks" → Done
- "Create CLAUDE.md" → `ln -sf AGENTS.md CLAUDE.md`
- "Create all symlinks" → `ln -sf AGENTS.md CLAUDE.md && ln -sf AGENTS.md .cursorrules && ln -sf AGENTS.md .windsurfrules`
## Content Mapping
Transform common patterns:
| Source Pattern | AGENTS.md Section |
|----------------|-------------------|
| "Run tests with..." | Testing instructions |
| "Code style: ..." | Code style |
| "Before committing..." | PR instructions |
| "Environment setup..." | Setup commands |
| "Security notes..." | Security |
## Example Transformation
```markdown
# Before (verbose .cursorrules, 80 lines)
## Code Style
- Use TypeScript strict mode
- Single quotes for strings
- No semicolons
- Max line length: 100 characters
- Functional components with hooks
- Colocate tests next to components
- Use meaningful variable names
- Avoid any type
- Prefer const over let
- Document complex functions with JSDoc
[... 50 more lines of detailed conventions ...]
# After (compact AGENTS.md, 60 lines)
## Code style
- TypeScript strict mode
- Single quotes, no semicolons
- Functional components with hooks
## PR instructions
- Use Conventional Commits (see agd:conventional-commits skill)
- Run `pnpm lint && pnpm test` before pushing
```
## Validation Checklist
After migration, verify:
- [ ] All commands are executable
- [ ] All recommended sections present (or intentionally omitted)
- [ ] Original content preserved (nothing lost)
- [ ] Format follows skill best practices
- [ ] File is concise (ideally under 100 lines)
- [ ] References folder only created if user wanted it
## Notes
- Always load the agents-md skill for context
- **Default to compact**: Create a simple AGENTS.md first
- Preserve all original content - migration should not lose information
- Only ask about references folder for verbose sources
- Ask user before deleting original files
- Validate migrated file before completing
- Offer symlink creation for backward compatibility
---
> Source: [Christophe1997/agent-extentions](https://github.com/Christophe1997/agent-extentions) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
加载上下文
移民来源
工艺流程
内容映射
验证清单
文件/命令 -> AGENT.md · .cursorrules · .windsurfrules · CLAUDE.md · contributing.md · ./docs/agents/testing.md · ../api/AGENTS.md · ln -sf AGENTS.md <original-file>
内容校验值 -> 3c7f49910569
当前原文的自动摘译,尚未人工审校。
加载上下文
加载 Agents-md 技能以获取格式指导:提供:部分、结构、符号链接模式、最佳实践
移民来源
检测并迁移常用代理文档文件:源文件·检测·迁移策略
AGENT.md·单文件前身·转换为AGENTS.md,确保覆盖所有部分.cursorrules·光标IDE规则·提取规则,转换为AGENTS.md部分.windsurfrules·Windsurf IDE规则·提取规则,转换为AGENTS.md部分工艺流程
检测源文件: 如果未指定源,则自动检测: 优先级: AGENT.md > .cursorrules > .windsurfrules > CLAUDE.md 如果找到多个文件则提示用户 读取并分析源文件:
内容映射
转换常见模式: 源模式 · AGENTS.md 部分“运行测试...” · 测试说明“代码样式:...” · 代码样式“在提交...之前” · PR 说明
验证清单
迁移后,验证: [ ] 所有命令均可执行 [ ] 所有推荐部分均存在(或有意省略) [ ] 保留原始内容(没有丢失) [ ] 格式遵循技能最佳实践