SuperAPI AI 工具集

instrument-agent-dotnet

编程与开发

查看项目

更新于 10-15 17:18

技能介绍

用途:在 .NET 仓库中安装 Arkandia 方法的非确定性配套层,让编码代理能使用团队工具,同时受团队限制约束。

主要能力:分两个产物,先 MCP 后钩子。MCP 文件 .mcp.json 决定代理能接触什么,例如直接查询团队跟踪器、文档和数据,而无需把内容粘贴到聊天中;钩子文件 .claude/settings.json 与 scripts/agent-hooks/*.sh 决定代理不能越过什么,检查无论代理是否主动执行都会运行。钩子目录共七个:默认启用密钥读取防护(PreToolUse 阻止读取 .env、私钥、secrets.json)和编辑后格式化(PostToolUse,对刚编辑的文件运行 dotnet format);另外提供危险命令拦截、依赖扫描(仅报告)、审计日志、包版本守护和生成文件守护,后两者只在仓库存在对应产物时才提供。

使用方式:先静默发现仓库状态,再检查先决条件(.NET SDK、Git Bash),然后与用户确认范围内要注册的 MCP 服务器和要安装的钩子,最后写入文件。写入前需确认工作树干净,写入后不会自动连接服务器,需在仓库中运行 claude 并接受信任对话框,再用 /mcp 确认。

适用场景:采用 .NET 并希望给编码代理设定工具边界与检查的团队。

限制:钩子按文本匹配而非意图匹配,以用户 shell 和权限运行,并非安全沙箱;注册配置仅 Claude Code 读取;脚本为 bash,Windows 上依赖 Git Bash;写入配置后可能因环境变量未导出被编辑器标红;不要修改 .claude/settings.local.json 或 permissions;本资料未提供完整的脚本模板与后续阶段内容。