conduct-cli Skill 技能

技能简介

conduct-cli 是 Conduct AI 的官方命令行工具，把「AI 智能体治理」装进终端：既能安装并管理 12 个官方 Playbook 智能体、批量跑端到端测试，也内置 ConductGuard 策略引擎——安全团队在控制台配一次策略，团队里每个开发者的 Claude Code、Cursor、Windsurf、Copilot CLI 会话都会自动套用同一套规则。工具运行于 Linux、macOS、Windows，支持 Python 3.9–3.12。

核心能力

• 策略统一执行：conduct guard sync 从服务端拉取最新策略到本地 policy.json，写入 PreToolUse Hook 并注册 MCP，开发者无需逐个配置。
• 三档处置动作：规则按 match_tool、match_pattern、match_path_pattern 匹配，命中后执行 block（退出码 2 中断调用）、warn（放行并提醒）或 audit（静默记录）。
• 敏感操作自检：注册的 conductguard-mcp 提供 guard_status、guard_check、guard_sync 三个工具，智能体可在执行 rm -rf、内网请求等动作前先问一句会不会被拦。
• 合规核验：conduct verify 把近 24 小时的策略事件映射到 OWASP Agentic Top 10（过度代理、权限提升、监控不足等 10 类），--strict 模式下有阻断事件即返回退出码 1，可直接进 CI。
• 资产发现与审计：conduct guard discover 扫描本机已安装的 AI 工具并报告 Guard 覆盖率，conduct guard audit 以表格输出近期事件，guard status 显示当日消耗、会话数与违规数。
• 智能体全生命周期：conduct playbooks 浏览可用智能体，conduct install-all --project X --repo o/r 一键装齐，conduct test --all 触发测试负载并流式回放，全过返回 0。

安装配置

1. 安装包：pip install conduct-cli，跨三平台可用。
2. 登录鉴权：conduct login --server https://api.conductai.ai --token cond_agt_xxx --workspace，Token 在控制台「Settings → Agents」签发，本地仅存 SHA-256 哈希。
3. 接入智能体：conduct login 后按需 conduct install 或 conduct install-all --project DevOps --repo myorg/myrepo，项目不存在会自动创建。
4. 开启 Guard：conduct login --api-key 后执行 conduct guard sync，Hook 与 MCP 自动写入 ~/.claude/settings.json，下次工具调用即生效。

使用步骤

1. 安装并登录：装好包后先完成 conduct login 一次性鉴权。
2. 浏览并安装：conduct playbooks 查看 12 个智能体，conduct install-all 装进指定项目。
3. 验证连通：conduct agents 查看已装清单，conduct test "PR Reviewer" 触发单个测试并流式看结果。
4. 同步团队策略：安全团队在 Guard 控制台下发规则后，本地执行 conduct guard sync 拉取最新 policy.json 并重写 Hook。
5. 日常巡检：用 conduct guard status 看当日消耗与违规，conduct guard audit --since 7d 回看事件，conduct verify --strict 在 CI 里做门禁。

适用场景

• 团队级 AI 工具管控：安全团队配一次策略，全员 Claude Code/Cursor/Windsurf 自动生效，无需逐台机器改配置。
• 危险操作拦截：禁止 rm -rf 强删、内网 curl、写入生产目录等高风险调用，阻断时把替代方案直接回给开发者。
• Agent 合规交付：用 conduct verify 输出 OWASP Agentic Top 10 映射证据，供审计与安全评审。
• CI 质量门禁：conduct test --all 与 verify --strict 的退出码可直接接入流水线，失败即构建失败。
• 覆盖率摸底：guard discover 找出团队里绕开管控的 AI 工具，--register 补登记。

适用人群

负责 AI 编程工具落地的安全与平台工程团队；希望给全组 Claude Code/Cursor 立统一红线的技术负责人；需要把 AI 调用纳入审计与 OWASP 合规框架的 DevSecOps 工程师；使用 Copilot CLI、Claude Desktop 等多宿主、想要一处管控的研发组织。

工作原理

conduct guard sync 同步时完成四件事：拉取策略写入 ~/.conduct/policy.json；生成 Python Hook 脚本 ~/.conduct/hook.py；把 Hook 注册进 ~/.claude/settings.json 的 PreToolUse 钩子；注册 conductguard-mcp 服务。此后 Claude Code 每次工具调用前先运行 Hook——从 stdin 读入 tool_name 与 tool_input，对照策略逐条匹配，按规则动作返回退出码完成放行、提醒或中止；同时异步向 /guard/events 投递审计事件，不阻塞调用。MCP 侧的 guard_check 走同一套匹配逻辑，让模型在动手前预判结果。策略托管在服务端，版本更新后重跑 sync 即可推送到全员。

官方链接

• PyPI 主页：https://pypi.org/project/conduct-cli/
• 产品官网：https://conductai.ai
• 文档：https://conductai.ai/docs
• GitHub 仓库：https://github.com/sseshachala/conductai