Cloudy0717/quality-sentinel
GitHub: Cloudy0717/quality-sentinel
一款为 AI 编码代理设计的全流程质量保障插件,通过计划审查、代码审查、测试审计和破坏性测试四阶段流水线在部署前系统化发现并拦截缺陷。
Stars: 1 | Forks: 0
# Quality Sentinel
[](LICENSE)
[](package.json)
[](#installation)
[](https://www.npmjs.com/package/quality-sentinel)
**一个在各个阶段发现问题的工具** —— 在构建之前、构建之中、测试之后,以及部署前夕。
Quality Sentinel 将红队思维、代码审查、测试审计和破坏性测试结合到一个统一的流水线中。它守护您的工作流的两个端点:在编码**之前**质疑计划,并在部署**之前**对完成的代码进行压力测试。
## 流水线
```
┌──────────────────────────────────────────────────────────────────┐
│ Quality Sentinel Pipeline │
├──────────┬──────────────┬────────────┬──────────────┬────────────┤
│ Step │ 1 │ 2 │ 3 │ 4 │
├──────────┼──────────────┼────────────┼──────────────┼────────────┤
│ Phase │ Design │ Coding │ Stabilize │ Pre-Deploy │
├──────────┼──────────────┼────────────┼──────────────┼────────────┤
│ Mode │ Plan Review │ Code Review│ Test Audit │Destructive │
│ │ (the-fool) │(code-rev.) │(test-master) │ Test(fool) │
├──────────┼──────────────┼────────────┼──────────────┼────────────┤
│ Purpose │ Challenge │ Catch bugs │ Fill test │ Red team + │
│ │ assumptions │ + misalign │ gaps │ boundary │
└──────────┴──────────────┴────────────┴──────────────┴────────────┘
```
**核心创新:** `the-fool` 对抗方法论守护**两端** —— 在编码前防止方向错误,并在部署前捕捉漏网之鱼。
## 使用时机
| 阶段 | 模式 | 发现内容 |
|-------|------|---------------|
| 编写代码前 | **Plan Review** | 假设、盲点、故障模式、薄弱证据 |
| PR/代码审查期间 | **Code Review** | 计划不一致、Bug、安全漏洞、性能问题 |
| 代码编写完成后 | **Test Audit** | 覆盖率缺口、遗漏的边缘情况、薄弱的断言 |
| 部署前夕 | **Destructive Test** | 生产环境故障模式、边界逃逸、二阶效应 |
| 端到端 | **Full Pipeline** | 按顺序执行所有 4 个阶段,生成统一报告 |
## 模式快速参考
| # | 模式 | 描述 |
|---|------|-------------|
| 1 | Plan Review | 在实现之前质疑想法(the-fool 前哨) |
| 2 | Code Review | 根据计划、架构和质量审查 PR/代码变更 |
| 3 | Test Audit | 审计测试覆盖率,生成缺失的测试 |
| 4a | Full Audit | 按顺序执行 计划 → 代码 → 测试 |
| 4b | Destructive Test | 对已完成的代码进行红队测试 + 边界模糊测试 + 反转(the-fool 后卫) |
| 5 | Full Pipeline | 包含全部 4 个阶段:计划 → 代码 → 测试 → 破坏性测试 |
## 安装
### OpenCode(插件安装 —— 推荐)
```
{
"plugin": ["quality-sentinel@latest"]
}
```
### OpenCode(手动路径)
```
{
"skills": {
"paths": ["~/.config/opencode/skills/quality-sentinel"]
}
}
```
```
cp -r quality-sentinel ~/.config/opencode/skills/
```
### 其他 Agent
克隆仓库并将您的 agent 技能路径指向 `quality-sentinel/`:
```
git clone https://github.com/Cloudy0717/quality-sentinel.git
```
## 用法
要求您的 agent 运行 Quality Sentinel:
```
/quality-sentinel
```
或调用特定模式:
```
Review this PR for quality
Run a full pipeline audit before we deploy
Challenge my architecture decisions
```
Agent 会自动检测模式,或者要求您进行选择。
## 输出格式
所有模式都会生成一份结构化报告:
```
Quality Sentinel Report
├── Summary
├── Critical Issues (must fix)
├── Major Issues (should fix)
├── Minor Issues (nice to fix)
├── Positive Feedback
└── Verdict / Deployment Decision
```
## 许可证
MIT 许可证 —— 详见 [LICENSE](LICENSE)。
标签:AI编程助手, MITM代理, SOC Prime, 代码审查, 开发工具, 暗色界面