代理

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

加载上下文

加载 Agents-md 技能以获取格式指导:提供:部分、结构、符号链接模式、最佳实践

移民来源

检测并迁移常用代理文档文件:源文件·检测·迁移策略AGENT.md·单文件前身·转换为AGENTS.md,确保覆盖所有部分.cursorrules·光标IDE规则·提取规则,转换为AGENTS.md部分.windsurfrules·Windsurf IDE规则·提取规则,转换为AGENTS.md部分

工艺流程

检测源文件: 如果未指定源,则自动检测: 优先级: AGENT.md > .cursorrules > .windsurfrules > CLAUDE.md 如果找到多个文件则提示用户 读取并分析源文件:

内容映射

转换常见模式: 源模式 · AGENTS.md 部分“运行测试...” · 测试说明“代码样式:...” · 代码样式“在提交...之前” · PR 说明

验证清单

迁移后,验证: [ ] 所有命令均可执行 [ ] 所有推荐部分均存在(或有意省略) [ ] 保留原始内容(没有丢失) [ ] 格式遵循技能最佳实践

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

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 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。