用途
Skill Sentinel 是一个“元代理”，用于监控、审计和演进技能生态系统。当用户提到“审计技能”“技能质量”“检查技能生态系统”“技能生态健康度”“重复技能”“优化技能”等话题时适用。若任务与 skill sentinel 无关，或存在更简单、更具体的工具可处理请求，或用户需要的是不具备领域专长的通用协助，则不适用。
主要能力
按 7 个维度分析所有技能，识别问题、建议改进并推荐新的专家型技能：
- 代码质量（权重 20%）：函数圈复杂度（阈值 10）、函数长度（阈值 50 行）、文件大小（阈值 500 行）、docstring 覆盖率、错误处理模式（bare except、broad except）。
- 安全性（权重 20%）：硬编码密钥（token、密码、API key）、SQL 注入（查询中使用 f-string）、不安全 HTTP URL、日志中的 token、输入验证。
- 性能（权重 15%）：API 重试与退避、超时配置、HTTP 连接复用、N+1 查询、异步/并发。
- 治理（权重 15%）：级别 0 无；级别 1 操作日志；级别 2 日志 + 速率限制；级别 3 完整（+ 两步确认）；级别 4 高级（+ 告警与趋势）。
- 文档（权重 15%）：带 frontmatter 的 SKILL.md（name、description、version）、触发关键词（葡语和英语）、必选与推荐章节、引用文件。
- 依赖（权重 15%）：是否存在 requirements.txt、版本是否固定、导入与列出的依赖是否一致。
- 跨技能分析（全局）：技能间重复模块、共享的数据库模式、治理不一致、可提取的机会。
此外还会分析成本影响：SKILL.md 大小（每次激活消耗的 token）、无索引的大引用文件、脚本输出冗长、缺少结构化 JSON 输出。推荐器会对照 20 类分类法识别生态中缺失的能力，并为建议的新技能生成可直接使用的 SKILL.md 模板。
使用方式
安装：
pip install -r C:\Users\renat\skills\skill-sentinel\scripts\requirements.txt
主要命令：
- 全部技能完整审计：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py
- 仅审计单个技能：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py --skill instagram
- 仅给出新技能建议：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py --recommend
- 与上次审计对比（趋势）：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py --compare
- JSON 输出：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py --format json
- 查看审计历史：python C:\Users\renat\skills\skill-sentinel\scripts\run_audit.py --history
- 发现可用技能：python C:\Users\renat\skills\skill-sentinel\scripts\scanner.py
- 查看 sentinel 审计日志：python C:\Users\renat\skills\skill-sentinel\scripts\governance.py
- 检查数据库：python C:\Users\renat\skills\skill-sentinel\scripts\db.py
常见工作流：首次审计生态生成完整报告；用 --compare 监控长期演进；部署前用 --skill 校验单个技能；用 --recommend 确定下一个应创建的技能。
结构说明
脚本区域包含 scanner.py（自动发现技能）、analyzers 下的 code_quality.py、security.py、performance.py、governance_audit.py、documentation.py、dependencies.py、cross_skill.py，以及 recommender.py、cost_optimizer.py、report_generator.py、run_audit.py（CLI 主入口）。references 包含 analysis_criteria.md（评分细则）、security_patterns.md（安全模式）、skill_template.md（新技能模板）、schema.md（数据库 schema）。data 下存放 sentinel.db 与 reports/ 报告目录。sentinel 自身也践行其治理主张：所有审计记入 action_log，评分历史存入 score_history 以支持趋势，报告保存在 data/reports/。
报告格式
生成的报告包含：执行摘要（评分表）、趋势（如有上次审计）、按严重程度分类的发现（critical/high/medium/low/info）、逐技能详细分析、新技能建议、按优先级排序的行动计划。
适用场景与限制
适用于技能生态的整体审计、单技能部署前检查、长期趋势监控、缺口分析与新技能推荐。使用时建议提供清晰具体的项目上下文，应用建议前先审查，并可与其他互补技能结合。常见误区包括：将本技能用于其领域之外的任务、未理解自身具体上下文就套用建议、未提供足够项目上下文。输出不应替代针对具体环境的验证、测试或专家评审；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。引用文件可参考 references 下的四个文档获取技术细节。