权限足迹审查员

技能文档

---
name: permission-footprint-reviewer
title: 权限足迹审查员
category: 开发工具
description: 梳理指定技能、脚本或工作流所需的权限清单，识别过度权限并给出最小权限替代方案与隔离建议。当用户需要审查脚本权限、制定最小权限方案、开展安全审计或自动化权限治理时触发。触发词：权限审查、最小权限、安全审计、权限治理。
---

# 权限足迹审查员

## 技能定位

权限足迹审查员是一个独立技能，负责梳理某个技能、脚本或工作流需要的权限，并提出最小权限替代方案。

### 适合使用的情况

- 审查某个脚本需要哪些权限
- 制定最小权限方案
- 输入通常包含：脚本说明、权限需求、运行环境
- 优先产出：当前权限足迹、用途说明、复核清单

### 不适合使用的情况

- 不绕过系统安全控制
- 不生成提权方法
- 如果用户想直接执行外部系统写入、发送、删除、发布、变更配置，先明确边界，再只给审阅版内容或 dry-run 方案

## 技能工作流

### 步骤1：接收输入并明确边界

接收用户提供的脚本说明、权限需求与运行环境信息。缺信息时，优先显式列出「待确认项」，而不是直接编造。遇到高风险、隐私、权限或合规问题，必须加上边界说明。

### 步骤2：重组任务书

把用户提供的信息重组成任务书，明确审查对象、运行环境与关注点，再进入结构化产出。

### 步骤3：生成交付内容

默认先给「可审阅草案」，再给「可执行清单」。按以下标准结构组织结果：

- 当前权限足迹
- 用途说明
- 过度权限
- 最小权限替代
- 隔离建议
- 复核清单

如果运行环境允许执行命令，可调用本地脚本生成或扫描：

```bash
python3 scripts/run.py --input <输入文件或目录> --output <输出文件>
```

如果当前环境不能执行脚本，则基于 `resources/template.md` 与 `resources/spec.json` 的结构直接产出文本。

### 步骤4：复核与交付说明

对照复核清单逐项确认，标注仍缺失的信息与建议的下一步动作，说明本次产出为只读审计结果，不包含任何系统变更。

## 本地资源

- 规范文件：`resources/spec.json`
- 输出模板：`resources/template.md`
- 示例输入输出：`examples/`
- 冒烟测试：`tests/smoke-test.md`

## 安全边界

- 只做审计和最小化建议。
- 默认只读、可审计、可回滚。
- 不执行高风险命令，不隐藏依赖，不伪造事实或结果。

使用说明

# 权限足迹审查员

梳理技能、脚本或工作流所需的权限，识别过度权限并给出最小权限替代方案。

## 使用

```bash
python3 scripts/run.py --input examples/example-input.md --output out.md
```

也可以直接说「审查这个脚本需要哪些权限」「给我最小权限方案」，按标准结构产出审阅版结果。

## 工作原理

脚本读取 `resources/spec.json` 中的配置驱动审查流程，把输入材料整理为包含「当前权限足迹、用途说明、过度权限、最小权限替代、隔离建议、复核清单」的结构化 Markdown 报告；无法执行脚本时，可按 `resources/template.md` 手工产出同样结构的内容。

## 目录结构

- `SKILL.md`：技能说明与工作流
- `scripts/run.py`：本地审查脚本
- `resources/spec.json`：结构化配置
- `resources/template.md`：输出模板
- `examples/`：示例输入输出
- `tests/smoke-test.md`：冒烟测试步骤

## 依赖

- `python3`，无额外三方依赖

## 风险提示

- 仅使用本地输入内容，不联网补事实
- 默认只读，不删除、不写外部系统、不发消息、不发布
- 若输入含个人信息或敏感材料，建议先脱敏再处理

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。