SuperAPI AI 工具集

score

写作与研究

查看项目

更新于 10-16 07:11

技能介绍

用途

Score 是一个用于评估提示词上下文工程质量的技能,借助 ContextStellar 的评分 API 对提示词文本进行打分。它适用于用户要求对提示词打分、分析或优化时,或在发送提示词之前审查其质量时。

主要能力

评分采用五个维度,各维度权重不同:

  • Token 利用率(25%):衡量浪费情况,包括礼貌用语、填充词、强调词和冗余。
  • 结构清晰度(23%):衡量 XML 标签、列表、标题、代码块、祈使关键词的使用。
  • 具体性(20%):衡量数字、格式关键词、角色设定、示例和约束的明确程度。
  • 内容密度(17%):衡量词汇多样性与 n-gram 重复情况。
  • 缓存友好度(15%):衡量时间戳、UUID、日期引用以及易变数据的位置是否合理。

评分结果会展示总分与等级,等级范围从 A+ 到 F:

  • A+(90 分以上):优秀,可直接用于生产的提示词。
  • A(80–89):很好,仍有细微优化空间。
  • B(70–79):良好,检测到部分浪费模式。
  • C(60–69):尚可,存在明显的优化机会。
  • D(50–59):较差,建议进行较大幅度重构。
  • F(低于 50):不合格,存在根本性问题。

使用方式

技能从 $ARGUMENTS 获取提示词文本。如果没有提供参数,会要求用户粘贴或描述想要评分的提示词。随后调用 ContextStellar 的 hooks 端点进行评分,示例命令如下:

curl -s -X POST "${CONTEXTSTELLAR_BASE_URL:-https://contextstellar.com}/api/v1/hooks/claude-code" \
  -H "Authorization: ${CONTEXTSTELLAR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"sessionId\": \"manual-score-$(date +%s)\",
    \"type\": \"PreToolUse\",
    \"toolName\": \"ManualScore\",
    \"toolInput\": { \"content\": $(echo "$PROMPT_TEXT" | jq -Rs .) }
  }"

结果展示包括:总分与等级、五个维度的分项得分、可操作的优化建议、token 数量与潜在可节省的 token 数。如果得分低于 B(低于 70),技能会主动给出具体的改进建议。

适用场景

  • 在向模型发送提示词之前检查其质量。
  • 对现有提示词进行打分、分析和优化。
  • 识别提示词中的浪费、结构与具体性问题。

限制

需依赖 ContextStellar 评分 API,并需要配置相应的 API Key 与基础地址(CONTEXTSTELLAR_API_KEY、CONTEXTSTELLAR_BASE_URL)。其他使用限制暂未提供。