pol-cova/mica
GitHub: pol-cova/mica
Mica 是一个本地优先的生产回归调查工作区，通过对比 Prometheus 遥测数据帮助人类工程师和 AI 编码代理协同排查线上问题。
Stars: 0 | Forks: 0
# Mica
[](https://go.dev/)
[](https://react.dev/)
[](https://www.docker.com/)
[](LICENSE)
Mica 是一个用于调查生产环境回归的本地工作区。它比较 Prometheus 窗口，并将证据、假设、代码更改和恢复检查存储在 SQLite 中。编码代理通过 MCP 访问同一个事件记录。
Mica 读取遥测数据，但不进行部署、重启服务或修改基础设施。只有在指定的审批人确认了准备好的草稿后，才会发送出站消息。
[观看 2:59 的产品演示](demo-video/out/mica-demo.mp4)或查看 [Remotion 源码](demo-video/README.md)。
## 使用 Codex 和 GPT-5.6 构建
Mica 是使用 Codex 通过规范驱动的工作流开发的。GPT-5.6 Sol 在中等和高级推理能力的引导下，主导了架构、实现、调试、产品审查和最终集成。GPT-5.6 Terra 子代理处理了有限的并行工作，例如代码库探索、针对性的实现和验证。
PRD 被转换为明确的工作流、架构和工作流图表、类型化接口、实现任务以及被跟踪的状态文档。然后 Codex 构建并完善了 Go daemon、React 工作区、MCP 工具、项目技能、测试、确定性评估、文档和 Remotion 演示。每个工作流都根据 PRD 进行了检查，并在被标记为完成之前通过本地演示进行了演练。
Codex 还将 Mica 作为一个代理使用，而不仅仅是作为一个编码助手。它通过本代码仓库中包含的相同入门说明和 MCP 接口进行连接，检查了事件证据，记录了调查工作，并验证了从最新遥测数据中的恢复情况。这使得产品规范、其实现以及真实的代理工作流之间形成了一个闭环。
## 工作流
1. 将健康的基准与事件窗口进行比较。
2. 检查确切的数值、阈值、Prometheus 查询和收集时间。
3. 记录假设、代码更改、测试和人为决策。
4. 使用最新的遥测数据再次检查原始的退化信号。
人类使用 Web 工作区。代理使用类型化的 MCP 工具。两者都会更新同一个持久化的事件和时间线。
## 运行演示
```
make demo-up
```
打开 [http://127.0.0.1:8787](http://127.0.0.1:8787)。在大约 30 秒的正常流量后，触发内置的 checkout N+1 回归：
```
MICA_DEMO_CONTROL_URL=http://127.0.0.1:8081 go run ./cmd/mica demo trigger n-plus-one
```
在工作区中选择 **Compare telemetry** 以创建证据。准备好验证恢复时重置场景：
```
MICA_DEMO_CONTROL_URL=http://127.0.0.1:8081 go run ./cmd/mica demo reset
```
完整的操作指南，请参见 [docs/demo.md](docs/demo.md)。
## 连接代理
若要通过单个文件进行安装、测试和 MCP 设置，请向任何兼容的编码代理提供以下指令：
```
Read and follow https://raw.githubusercontent.com/pol-cova/mica/main/AGENTS.md
```
或直接下载指南：
```
curl -fsSLO https://raw.githubusercontent.com/pol-cova/mica/main/AGENTS.md
```
Mica 运行后，其本地入门技能也可用：
```
Read and follow http://127.0.0.1:8787/agent-onboarding/SKILL.md
```
该设置文件会检查 daemon，配置 MCP，验证可用工具，并选择特定于任务的技能。你也可以[在仓库中阅读它](web/public/agent-onboarding/SKILL.md)。
要继续在工作区中创建的事件，请打开其 **Agent** 标签页并复制事件交接信息。它包含服务、完整的事件 ID、证据 ID 以及下一个工作流，以便代理更新现有记录。
对于手动设置，请将 Mica 添加到客户端的 MCP 配置中：
```
{
"mcpServers": {
"mica": {
"command": "go",
"args": ["run", "./cmd/mica", "mcp"]
}
}
}
```
MCP server 公开服务上下文、回归检测、证据检查、相关性分析、假设/更改记录、提案、安全通信草稿起草、审计结果和恢复验证。它无法部署、重启服务、修改基础设施或对外发布。
## 文档
| 我想… | 阅读 |
| --- | --- |
| 运行完整的回归流程 | [演示](docs/demo.md) |
| 连接编码代理 | [代理设置](docs/agent-setup.md) |
| 配置目录、Prometheus 或目标 | [配置](docs/configuration.md) |
| 了解共享的人类和代理模型 | [架构](docs/architecture.md) |
| 查看已实现的 PRD 范围 | [PRD 状态](docs/prd-status.md) |
| 观看或重新构建产品影片 | [演示影片](demo-video/README.md) |
| 浏览所有指南 | [文档索引](docs/README.md) |
项目范围的技能位于 [`.agents/skills`](.agents/skills)。
## 开发
```
make test
make eval
make build
```
`make eval` 运行确定性的 MVP 评分。`make eval-skills` 仅检查打包的代理技能。每个 PRD 工作流的实现状态记录在 [docs/prd-status.md](docs/prd-status.md) 中。
连接到受保护的 Prometheus 源时，请设置 `MICA_PROMETHEUS_BEARER_TOKEN`，或 `MICA_PROMETHEUS_BASIC_USER` 以及 `MICA_PROMETHEUS_BASIC_PASSWORD`。Mica 绝不会通过其 API 或 MCP server 返回这些凭据。
要启用出站交付，仅需使用 `MICA_SLACK_WEBHOOK_URL`、`MICA_DISCORD_WEBHOOK_URL` 和/或 `MICA_TELEGRAM_BOT_TOKEN` 以及 `MICA_TELEGRAM_CHAT_ID` 配置 daemon。
## 许可证
MIT — 详见 [LICENSE](LICENSE)。
标签：API集成, Go, MCP, React, Ruby工具, Syscalls, 可观测性, 故障排查, 日志审计, 版权保护, 生产环境, 自动化攻击, 自定义请求头, 运维