Files
jiangnan fe5a3ff720 完善 Cursor 使用说明:补充安装后激活步骤和常见问题
- README.md: 扩展 Cursor 章节,增加 Settings > Rules > Project Rules 操作路径、
  使用示例和常见问题排查
- README.zh-TW.md: 同步更新繁体中文版
- integrations/cursor/README.md: 更新安装路径、新增 Finding and Activating Rules
  和 Troubleshooting 章节,修正智能体数量为 180
2026-03-22 08:00:21 +08:00

1.4 KiB

Cursor Integration

Converts all 180 Agency agents into Cursor .mdc rule files. Rules are project-scoped — install them from your project root.

Install

# Convert first, then install from your project root
./scripts/convert.sh --tool cursor
cd /your/project
/path/to/agency-agents-zh/scripts/install.sh --tool cursor

This creates .cursor/rules/<agent-slug>.mdc files in your project.

Finding and Activating Rules

After installation, rules default to alwaysApply: false, meaning they won't activate automatically. You need to enable them manually:

  1. Open Cursor Settings (Cmd+, / Ctrl+,) → RulesProject Rules
  2. You'll see all installed agent rules listed there
  3. Toggle on the agents you need (avoid enabling all 180 at once — too much context)
  4. Once enabled, the rules automatically apply in Cursor Chat and Composer

Alternatively, reference an agent in your prompt:

@rules Use the frontend developer standards to review this component.

Or enable a rule as always-on by editing its frontmatter:

---
description: Expert frontend developer...
globs: "**/*.tsx,**/*.ts"
alwaysApply: true
---

Troubleshooting

If you can't see rules in Cursor:

  • Ensure .cursor/rules/ is in your project root (not a global directory)
  • Files must have .mdc extension (not .md)
  • Try reopening the project or restarting Cursor

Regenerate

./scripts/convert.sh --tool cursor