SAAI技能反馈
直接从您的对话中提交有关Claude MCP技能的反馈。
报告错误、请求增强或提出新技能——所有这些都在ServiceNow SBO中跟踪，并具有完整的对话上下文。
______________________________________________________________________
快速开始
安装
git clone https://github.com/ServiceNow/saai-skill-feedback.git
cd saai-skill-feedback/mcp-server
./install.sh用它
告诉克劳德：
"Report a bug with create-sbo-request"
"Request an enhancement to make dashboard lookups fuzzy"
"Request a new skill for Jira ticket management"Claude会自动检测你正在谈论的技能，并提交完整的反馈。
______________________________________________________________________
这有什么作用
不要手动提交错误报告或功能请求，只需在Claude对话中提及即可：
- 自动检测 对话历史中的哪种技巧
- 捕获上下文 自动（工具调用、错误、参数）
- 丰富反馈 技术细节
- 创建SBO 在ServiceNow中进行跟踪
- 分配给维护人员 自动地
______________________________________________________________________
特性
错误报告
当某事不起作用时，只需说：
"Report a bug - the dashboard lookup failed"克劳德将：
- 找出调用了哪个工具
- 提取错误消息
- 使用的捕获参数
- 创建包含所有详细信息的SBO
增强请求
当你想要改进时：
"Request enhancement - support partial dashboard names"克劳德将：
- 描述当前行为
- 解释期望的行为
- 捕获用例
- 提交增强请求
新技能请求
当你需要新的东西时：
"Request a skill for Jira ticket management"克劳德将：
- 捕获用例
- 提取要求
- 创建新技能请求SBO
______________________________________________________________________
安装
看 docs/INSTALL.md 有关详细的设置说明。
需求:
- Node.js 18+
- Python 3.8+
- ServiceNow帐户（surf.ServiceNow.com）
快速安装:
cd mcp-server
./install.sh这将：
- 安装Node.js和Python依赖项
- 使用ServiceNow进行身份验证（基于浏览器）
- 显示要添加到Claude的配置
______________________________________________________________________
配置
添加到您的Claude配置文件中：
克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"saai-skill-feedback": {
"command": "node",
"args": ["/absolute/path/to/saai-skill-feedback/mcp-server/index.js"]
}
}
}克劳德代码 (~/.config/claude/config.json):
{
"mcpServers": {
"saai-skill-feedback": {
"command": "node",
"args": ["/absolute/path/to/saai-skill-feedback/mcp-server/index.js"]
}
}
}______________________________________________________________________
运作原理
自动检测
当你说“报告错误”时，克劳德：
- 扫描最近的对话（最后10-15条消息）
- 查找最后一个MCP工具调用
- 提取技能名称
- 捕捉相关上下文
上下文捕捉
对于错误报告，捕获：
- 工具名称和参数
- 错误消息
- 预期行为与实际行为
- 用户描述
如需增强功能：
- 当前限制
- 期望的改进
- 用例和好处
对于新技能：
- 需要解决的问题
- 预期功能
- 为什么现有技能不起作用
SBO创建
使用以下命令创建ServiceNow SBO：
- 标题：“｛表情符号｝｛类型｝：｛技能名称｝”
- 描述：带上下文的完整反馈
- 工作活动：“平台开发-安全BOS应用”
- 分配给：David Rider（技能维护者）
- 状态：已开放
______________________________________________________________________
示例
错误报告
User: "Create an SBO for fixing the security dashboard"
[Tool error: Dashboard not found]
User: "Report a bug - it should find partial matches"
Claude: [Auto-detects skill_name="create-sbo-request"]
Claude: [Captures error and parameters]
Claude: [Submits SBO with enriched context]
Claude: "✓ Feedback submitted as SBO DSRT0123456"增强请求
User: "It would be great if the tool supported date ranges"
Claude: "Would you like me to submit that as an enhancement?"
User: "Yes"
Claude: [Detects skill from recent usage]
Claude: [Captures current behavior vs desired]
Claude: [Submits enhancement SBO]新技能请求
User: "I wish I could query Snowflake from Claude"
Claude: "I don't have that capability. Want me to request a new skill?"
User: "Please"
Claude: [No skill detection needed - it's a new skill]
Claude: [Captures use case and requirements]
Claude: [Submits new skill request SBO]______________________________________________________________________
文档
- docs/CLAUDE.md -克劳德详细说明
- docs/INSTALL.md -安装指南
- docs/TEAM_MESSAGE.md -如何向团队推广
______________________________________________________________________
反馈类型
| 类型 | 何时使用 | 示例 |
|---|---|---|
| 程序错误 | 有东西坏了 | 仪表板查找失败，工具返回错误 |
| 增强 | 改进现有功能 | 添加模糊匹配，支持日期范围 |
| 新技能 | 需要新功能 | Jira集成，雪花查询 |
______________________________________________________________________
ServiceNow详细信息
- 例子: https://surf.service-now.com
- 表格:
x_snc_security_d_0_dsrtable（安全BOS） - 受托人：David Rider（技能维护者）
- 工作活动：平台开发-安全BOS应用程序
所有反馈都作为ServiceNow中的标准SBO请求进行跟踪。
______________________________________________________________________
认证
使用与其他ServiceNow技能相同的基于浏览器的身份验证：
- 运行安装脚本
- Okta登录时浏览器打开
- 完整MFA
- 凭据缓存在
~/.servicenow_surf_session.json - 过期时自动刷新
看 docs/INSTALL.md 有关身份验证详细信息。
______________________________________________________________________
故障排除
工具未显示？
- 完全重新启动Claude
- 开始新的对话
- 检查配置文件路径是否为绝对路径（非相对路径）
身份验证错误？
- 重新运行：
python3 src/utils/login_and_extract.py - 完成浏览器登录
- 检查凭据：
ls -la ~/.servicenow_surf_session.json
无法检测技能？
- 明确提及技巧：“使用create sbo请求报告错误”
- 克劳德会问是否真的模棱两可
______________________________________________________________________
面向开发者
项目结构
saai-skill-feedback/
├── mcp-server/
│ ├── index.js # MCP server entry point
│ ├── package.json # Node dependencies
│ └── install.sh # Installer script
├── src/
│ ├── submit_feedback.py # Feedback submission logic
│ └── utils/
│ ├── session_manager.py # ServiceNow auth
│ └── login_and_extract.py # Browser automation
└── docs/
├── CLAUDE.md # Instructions for Claude
├── INSTALL.md # User installation guide
└── TEAM_MESSAGE.md # Rollout templates技术栈
- Node.js：使用@modelcontextprotocol/sdk的MCP服务器
- python：ServiceNow API集成
- 硒：用于身份验证的浏览器自动化
- ServiceNow REST API：SBO创建
添加对新反馈类型的支持
编辑 src/submit_feedback.py:
EMOJI_MAP = {
'bug': '🐛',
'enhancement': '✨',
'new_skill': '💡',
'your_new_type': '🎯', # Add here
}______________________________________________________________________
贡献
关于反馈技巧的反馈？用反馈技巧报告！（meta）
或者在GitHub上提交问题/PR。
______________________________________________________________________
许可证
MIT许可证-请参阅许可证文件
______________________________________________________________________
学分
由ServiceNow的安全分析团队构建。
使用Anthropic的模型上下文协议（MCP）。