前言¶
内容审核、作业查重、投稿初审等流程里，经常需要判断一段文字是否由大模型生成。自建规则或关键词很难跟上生成质量的变化；单独对接云 API 又要维护鉴权、请求格式和错误处理。若你已经在 Cursor、Claude Code 等环境里用 Skill 扩展 Agent 能力，可以把「文本 AIGC 检测」做成可复用的技能，由 Agent 按统一说明调用腾讯云能力。
下面介绍 SkillHub 上的 TencentCloud Text AIGC Detection（坐标 @tencent-adm/tencentcloud-aigc-recog-text），以及安装与使用时的要点。
这是什么¶
TencentCloud Text AIGC Detection 是腾讯云 AI 生成文本识别能力对应的 Agent Skill，发布者为腾讯云内容识别团队，在 SkillHub 上标记为 enterprise 来源，分类为 data-analysis，当前版本 1.0.8。
技能定位：面向 AI 生成文本检测、文本真伪鉴别、AI 写作检测、AIGC 检测 等场景，让 Agent 在对话或工作流中按 SKILL.md 约定调用腾讯云文本 AIGC 识别服务，而不是每次手写调用代码。
核心功能¶
依据 SkillHub 公开说明，该技能覆盖的能力边界如下：
- AI 生成文本检测：对给定文本判断是否具备 AI 生成特征（具体判定字段与阈值以技能内文档及腾讯云接口为准）。
- 真伪鉴别 / 写作检测：适用于需要区分人工撰写与模型生成内容的审核、风控辅助场景。
- 与 Agent 集成：遵循通用 SKILL.md 格式，安装后由 Agent 读取技能说明并执行检测任务。
SkillHub 标签 requires_api_key=true，表示使用前需配置腾讯云相关 API 密钥；未配置时技能无法正常调用云端接口。
安装与启用¶
官方页面给出的安装方式，是让 Agent 按 SkillHub 安装文档拉取该技能包，而不是手动 git clone 仓库。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装步骤与优先源策略说明见：https://skillhub.cn/install/skillhub.md
2、安装本技能到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，Agent 可能识别不到。
skillhub install @tencent-adm/tencentcloud-aigc-recog-text --dir <你的 skills 目录>
常见路径示例（以你本机为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
SkillHub 页面亦提供等价提示：请根据 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/tencentcloud-aigc-recog-text。
3、配置 API 密钥¶
技能标记为需要 API Key。请在腾讯云控制台开通内容识别 / AI 生成文本识别相关产品能力，并按技能包内 SKILL.md 或附带脚本的说明配置密钥与环境变量。具体变量名、地域、接口版本以安装后的技能文档为准，本文不臆造配置项名称。
安装或更新技能后，若 Agent 未加载新技能，按你所用客户端要求重启或重新打开工作区。
典型用法¶
公开页面未附带独立 REST 示例；可复现的流程如下。
- 完成上一节的 CLI 安装与
skillhub install，确认@tencent-adm/tencentcloud-aigc-recog-text已出现在目标 skills 目录。 - 按技能文档配置腾讯云 API 密钥。
- 在 Agent 对话中明确任务，例如：「使用 TencentCloud Text AIGC Detection，检测下面这段文字是否为 AI 生成」，并粘贴待检文本。
Agent 应读取技能说明，调用封装好的检测逻辑并返回识别结果。批量检测、与自有流水线结合时，同样通过自然语言或项目内自动化脚本触发，具体参数以技能内约定为准。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skill 的客户端，希望在对话或脚本里做文本 AIGC 检测的团队。
- 希望统一走腾讯云内容识别能力、避免各项目重复对接 SDK 的开发者。
使用注意
- 计费与配额：调用的是腾讯云线上服务，需遵守产品计费与调用频率限制。
- 密钥安全：
requires_api_key=true，不要把 SecretId、SecretKey 写进公开仓库或聊天记录；用环境变量或客户端安全配置。 - 判定边界：检测结果用于辅助审核，不宜单独作为法律或学术认定的唯一依据；敏感场景应保留人工复核。
- 版本：SkillHub 当前展示版本为 1.0.8；升级可用
skillhub对同一坐标更新，并再次核对 SKILL.md 变更。
SkillHub 统计（页面与抓取数据一致方向）：评分 100000，下载约 2401，安装约 103，反映其在数据分析类技能中的使用量，但不代表检测准确率；准确率以腾讯云产品文档与实测为准。
结尾¶
TencentCloud Text AIGC Detection 把腾讯云 AI 生成文本识别封装成 Agent Skill，适合在已有 Skill 工作流里做 AIGC 检测与文本真伪辅助判断。安装走 SkillHub 标准流程，使用前准备好 API Key 并阅读包内 SKILL.md。
