Files
Agent-System/.doc/ops/2026-09-23-agentctl-cursor-integration.md
T
WeiCHEN 821a307feb feat(ops): add Cursor skills/MCP/rules/hooks for agentctl
Wrap the live coordinator in project Cursor capabilities so agents
default to leases, docs apply, and daemon enqueue. Track skills/hooks/mcp
via .gitignore exceptions; guard destructive git with ask permission.
2026-09-23 19:23:40 +08:00

1.8 KiB
Raw Blame History

title, status, created, updated, owner, task_id
title status created updated owner task_id
agentctl Cursor 能力层(skills / MCP / rules / hooks) active 2026-09-23 2026-09-23 Cursor agentctl-cursor-integration-2026-09-23

agentctl Cursor 能力层

把已上线的 agentctl 管理面包装为 Cursor 原生能力,使 agent 默认走租约 / docs 收据 / 候选合入。

能力清单

层 路径 作用
MCP .cursor/mcp.json → scripts/mcp/agentctl-mcp.mjs status / task_* / lease_run / docs_* / validate / queue_enqueue / quarantine_status
Skills .cursor/skills/agentctl-* 会话启动、建场、租约写、集成收口
Rule .cursor/rules/agentctl-mandatory.mdc alwaysApply:强制走 agentctl
Hooks .cursor/hooks.json + guard-git.sh git push / 破坏性 git → permission: ask

权威规则仍是 AGENTS.md 与 操作规范;本目录不复制全文。

启用

  1. 合入 local dev 后,在 Cursor 中 Reload Window 或重载 MCP。
  2. 确认 MCP 服务器 agentctl 出现在工具列表;hooks 出现在 Cursor Hooks 设置页。
  3. 会话开始跟 skill agentctl-session-start(核对 daemon status)。

与管理面关系

  • launchd com.agentctl.coordinator 持续 queue schedule;本能力层只封装 CLI,不替代 daemon。
  • git hooks(pre-commit / pre-merge / reference-transaction)仍由 agentctl hooks 管理,与 Cursor beforeShellExecution 互补:前者执行租约/候选门禁,后者拦未授权 push/强推。

非目标

不 push;不晋升 test/main;不改 gap-matrix;不卸载 daemon。