内容
政策哨兵代理
将工作场所问题转化为有引文的政策指导和审计准备的行动。
政策哨兵代理是企业代理黑客马拉松提交的项目，它根据合成的工作场所请求审查合成的公司政策，然后生成有引文的指导、风险标记、安全下一步骤、例外路径、后续任务和审计准备的记录。
## 适用轨道
- 轨道：企业代理
- 主要微软智力层：工作智力
- 奖励证据：MCP 应用脚手架、外部 MCP 风格的读写服务器、OAuth 安全脚手架
- 数据姿态：仅合成数据
## 安全声明
政策哨兵代理包括一个微软 365 副驾驶声明代理脚手架、MCP 应用就绪配置、外部 MCP 服务器演示、OAuth 安全脚手架和确定性的本地备用方案，以实现可靠的判断。
本存储库不包含真实的微软 365 凭证、租户 ID、Azure 密钥、客户数据、个人可识别信息、机密政策或生产日志。
本存储库不声称拥有实时微软 365 副驾驶部署、实时 Foundry 部署或实时生产 OAuth 集成。
## 演示场景
合成请求：
```text
经理希望批准使用个人电子邮件地址的承包商，并跳过安全审查，因为项目很紧急。我们应该怎么做？
```
预期决定：不要原样批准。生成的简报解释了高风险政策问题，引用了合成政策文件，并推荐了安全后续行动。
## 快速开始
运行确定性的本地演示：
```bash
PYTHONPATH="$PWD/src" python3 -m policy_sentinel_agent demo
```
生成完整的判断证据包：
```bash
PYTHONPATH="$PWD/src" python3 -m policy_sentinel_agent export
```
运行最终存储库就绪检查：
```bash
PYTHONPATH="$PWD/src" python3 -m policy_sentinel_agent final-check
```
运行所有冒烟测试：
```bash
python3 tests/test_all_smoke.py
```
预期成功标记：
```text
POLICY_SENTINEL_DEMO_OK
POLICY_SENTINEL_EXPORT_OK
POLICY_SENTINEL_FINAL_CHECK_OK
POLICY_SENTINEL_ALL_SMOKE_OK
```
## 演示生成的内容
export 命令在 `demo/output/` 下创建安全的合成工件：
- `policy_sentinel_brief.md`
- `action_plan.md`
- `audit_log_summary.md`
- `risk_register.md`
- `work_iq_alignment.md`
- `mcp_bonus_evidence.md`
- `final_report.html`
- `release_manifest.json`
- `judge_evidence_console.md`
## 代理工作流
确定性的本地工作流是顺序的且可供审阅：
1. 请求受理代理
2. 政策检索代理
3. 风险分析代理
4. 行动计划代理
5. 安全验证代理
工作流在本地实现，以实现可靠的判断，无需云凭证。
## MCP 证据
MCP 风格的读写证据位于 `mcp-server/tools.py` 和 `mcp-server/server.py`。
读取工具：
- `search_policy`
- `get_policy_document`
- `get_employee_context`
- `get_prior_exception_patterns`
写入工具：
- `create_policy_task`
- `append_audit_event`
- `create_exception_request`
- `update_risk_register`
MCP 冒烟测试写入临时复制的 JSON 文件，因此在验证期间不会污染提交的演示数据。
运行：
```bash
PYTHONPATH="$PWD/mcp-server" python3 tests/test_mcp_tools.py
```
预期输出：
```text
MCP_TOOLS_SMOKE_OK
```
## OAuth 和安全脚手架
OAuth 保护证据位于：
- `src/policy_sentinel_agent/oauth_guard.py`
- `tests/test_oauth_guard.py`
- `docs/security/oauth_scaffold.md`
- `config/oauth.example.json`
运行：
```bash
PYTHONPATH="$PWD/src" python3 tests/test_oauth_guard.py
python3 tests/test_secret_hygiene.py
```
预期输出：
```text
OAUTH_GUARD_SMOKE_OK
SECRET_HYGIENE_OK
```
## 微软 365 副驾驶脚手架
副驾驶风格的脚手架证据位于：
- `copilot-agent/declarativeAgent.scaffold.json`
- `copilot-agent/mcp_app_manifest.scaffold.json`
- `copilot-agent/instructions.md`
- `docs/microsoft_iq_alignment.md`
运行：
```bash
python3 tests/test_copilot_scaffold.py
```
预期输出：
```text
COPILOT_SCAFFOLD_SMOKE_OK
```
## 工作智力对齐
政策哨兵代理通过推理工作场所上下文与工作智力对齐：角色、政策请求、批准、任务、风险、例外路径和审计历史。当前项目使用合成本地数据安全地演示工作流。
## 安全立场
- 仅合成数据
- 无真实凭证
- 无租户 ID
- 无访问令牌
- 无刷新令牌
- 无私钥
- 无客户数据
- 无机密内部政策
- 无不支持的实时部署声明
## 审阅证据文件
- `docs/release_manifest.md`
- `docs/demo_video_script.md`
- `docs/final_submission_checklist.md`
- `docs/checkpoints/phase_0_checkpoint.md` 至 `docs/checkpoints/phase_5_checkpoint.md`
- `demo/output/judge_evidence_console.md` 由 export 生成
## 最终提交关口
在提交之前，运行：
```bash
PYTHONPATH="$PWD/src" python3 -m policy_sentinel_agent export
PYTHONPATH="$PWD/src" python3 -m policy_sentinel_agent final-check
python3 tests/test_all_smoke.py
python3 tests/test_secret_hygiene.py
```
所需输出：
```text
POLICY_SENTINEL_EXPORT_OK
POLICY_SENTINEL_FINAL_CHECK_OK
POLICY_SENTINEL_ALL_SMOKE_OK
SECRET_HYGIENE_OK
```
## 冻结规则
在 README、final-check、all-smoke、secret hygiene、demo 脚本和提交文本准备就绪后，停止功能工作。仅修复已证明的阻塞问题。
