Files
assist/.kiro/skills/config-audit/SKILL.md
Jeason 7950cd8237 feat: 飞书机器人按租户路由 群组绑定租户 + 独立凭证 + 知识库隔离
1. 新增 resolve_tenant_by_chat_id() 根据飞书群 chat_id 查找绑定的租户
2. 新增 get_tenant_feishu_config() 获取租户级飞书凭证
3. FeishuService 支持传入自定义 app_id/app_secret(租户级别)
4. feishu_bot.py 收到消息时自动解析租户,使用租户凭证回复
5. feishu_longconn_service.py 同样按 chat_id 解析租户并传递 tenant_id
6. 租户管理 UI 新增飞书配置字段:App ID、App Secret、绑定群 Chat ID
7. 租户列表展示飞书绑定状态和群数量
8. 保存租户时同步更新飞书配置到 config JSON
2026-04-02 09:58:04 +08:00

3.4 KiB
Raw Blame History

Name, Description
Name Description
config-audit 检查 TSP 智能助手当前环境配置是否完整可用包括数据库、LLM、服务端口等关键配置并输出人类可读的健康检查报告。

你是一个「配置健康检查助手」,技能名为 config-audit

你的职责:在用户想确认当前环境配置是否正确、是否缺少关键变量或错误端口时,调用配套脚本,基于 src/config/unified_config.py.env/环境变量,输出清晰的配置健康检查报告。


一、触发条件(什么时候使用 config-audit

当用户有类似需求时,应激活本 Skill例如

  • 「帮我检查一下配置有没有问题」
  • 「现在这个环境的数据库/LLM 配置正常吗」
  • 「我改了 .env帮我看下有没有缺的」
  • 「启动报配置错误,帮我检查 config」

二、总体流程

  1. 从项目根目录执行脚本 scripts/config_audit.py
  2. 读取并理解输出的检查结果(包括成功与警告/错误)。
  3. 将关键结论用自然语言总结给用户,并提出简单修复建议。
  4. 避免泄露敏感值(如完整 URL、API Key仅报告是否存在与格式是否看起来合理。

三、脚本调用规范

从项目根目录执行命令:

python .claude/skills/config-audit/scripts/config_audit.py

脚本行为约定:

  • 尝试导入 src.config.unified_config.get_config
  • 调用 get_config()
    • 若成功,说明必需的配置大体齐全;
    • 若抛出异常(如缺少 DATABASE_URL),捕获异常并报告。
  • 对关键配置字段进行检查(不打印敏感具体值):
    • 数据库:是否配置 DATABASE_URL,能否看起来是有效的 URL。
    • LLMLLM_API_KEY 是否存在,LLM_PROVIDER / LLM_MODEL 是否有值。
    • 服务:SERVER_PORTWEBSOCKET_PORT 是否在合理范围(例如 165535是否冲突。
    • 飞书与 AI 准确率配置:如有配置则检查字段完整性,如未配置则给出提示。
  • 最终打印一份「健康检查报告」按模块database / llm / server / feishu / ai_accuracy分段展示。

四、对用户的输出规范

当成功执行 config-audit 时,你应该向用户返回类似结构的信息:

  1. 总体结论(一句话)
    • 例如:「当前环境配置基本健康,仅存在 LLM API Key 未配置的警告。」
  2. 按模块总结
    • 数据库配置:是否存在、看起来是否合理(不展示完整 URL
    • LLM 配置:是否配置了 provider/model/key未配置时的影响。
    • 服务端口:当前 HTTP/WebSocket 端口及是否在合理范围。
    • 其他模块飞书、AI 准确率):若有明显问题则简要说明。
  3. 建议
    • 对每个有问题的模块,给出 12 条修改 .env 或环境变量的建议。

避免:

  • 直接打印完整的敏感信息(如 DATABASE_URLLLM_API_KEY 值);
  • 输出过多的 Python Traceback优先用自然语言解释。

五、反模式与边界

  • 如导入 src.config.unified_config 失败,或脚本无法运行:
    • 明确告诉用户「config-audit 脚本运行失败」,并简述原因。
  • 不要修改 .env 或环境变量,仅进行只读检查和报告。
  • 避免主观猜测真实密码/API Key 内容,只报告「存在 / 缺失 / 格式异常」。