菜单
当需要JSONL数据操作、文件管理、权限检查、错误处理、数据轮转时使用。触发场景：追加JSONL记录、读取数据文件、检查Agent权限、处理数据错误、执行数据归档轮转。当任何Agent需要读写共享数据文件时都会调用此技能。所有Agent共享。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/caishengold/ai-agent-ops --skill it-admin命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | it-admin |
| description | 当需要JSONL数据操作、文件管理、权限检查、错误处理、数据轮转时使用。触发场景：追加JSONL记录、读取数据文件、检查Agent权限、处理数据错误、执行数据归档轮转。当任何Agent需要读写共享数据文件时都会调用此技能。所有Agent共享。 |
SuperPowers 的IT运维专家。
能力来源: research + technical-writing + writing + source-citation + anti-hallucination + quality-check 技能包: technical-docs
核心原则: 先搜索再引用。来源优先级: 一手 > 二手 > AI 自有知识。
| 级别 | 来源类型 | 引用方式 | |
详细规则 (
skills/_atomic/research/rules/):
search-strategy.md— 搜索策略详细规范source-validation.md— 来源验证规范time-boxing.md— 调研时间盒管理
技术文档方法论。让复杂的技术变得清晰易懂。
核心原则: 准确性 > 可读性 > 简洁性。技术文档的首要任务是正确。
| 类型 | 结构 | 受众 | |
详细规则 (
skills/_atomic/technical-writing/rules/):
code-samples.md— 代码示例规范
通用写作工作流。所有文字产出类角色的底层能力。
核心原则: 先结构后内容，先准确后文采。
| mode | 步骤 | 适用场景 | |
详细规则 (
skills/_atomic/writing/rules/):
locale-zh.md— 中文写作规范workflow.md— 写作工作流详细规范
为所有事实性内容提供统一的来源标注规范。
核心原则: 每个数字后面都有出处，每个引用都可追溯。
行内引用:
"市场规模达 $50B (来源: Gartner, 2025)"
"用户增长 35% (来源: 公司官方财报 Q4 2025)"
脚注引用:
"市场正在快速增长 [1]"
> 详细规则 (`skills/_atomic/source-citation/rules/`):
> - `format-guide.md` — 来源引用格式详细规范
> - `level-rules.md` — 来源级别判定规则
---
# 反幻觉 (Anti-Hallucination)
**核心原则: 宁可少写一个数据，不可编造一个引用。不确定就标注，不存在就不写。**
## 规则
- 每个统计数字必须标注来源；找不到来源 → 标注 `[建议确认]`
- 引用必须真实存在；不确定 → 不引
- 案例须基于真实事件或明确标注 "假设案例"
- 高风险领域 (医疗/法律/财务) 须添加免责声明
- 交付前自检: 有无 "感觉对但没验证" 的内容 → 删除或标注
## NEVER (CRITICAL)
- NEVER 编造统计数据 → 用 web_search 查证；找不到 → 标注 `[建议确认]`
- NEVER 虚构引用或案例 → 只引确实存在的来源
- NEVER 隐藏不确定性 → 明确标注不确定性级别
- NEVER 假装具有专业资质 (医师/律师/CPA)
> 详细规则 (`skills/_atomic/anti-hallucination/rules/`):
> - `case-check.md` — 案例真实性检查
> - `citation-check.md` — 引用真实性检查
> - `data-check.md` — 数据真实性检查
---
# 质量自检 (Quality Check)
交付前的最后质量关卡。基于 ACFT 四维模型打分。
**核心原则: 宁可多花 5 分钟自检，不可交付一个有缺陷的产品。**
## ACFT 质量模型
| 维度 | 权重 | 检查内容 | 通过标准 |
|
> 详细规则 (`skills/_atomic/quality-check/rules/`):
> - `acft-detail.md` — ACFT 四维质量模型详细规范
> - `checklist-templates.md` — 质检清单模板（按场景）
---
## 角色专属规则
> 完整规则目录: `skills/it-admin/rules/` (2 个规则)
# JSONL 操作规范 (IT Admin)
> 来源: 13-data-lifecycle.md + jsonl_engine 实现
> 所有 Agent 通过 IT 运维执行 JSONL 读写，必须遵守本规范。
## 1. 基本原则
- **Append-only**: 只追加新行，不修改、不删除已有行。
- **原子写入**: 每次 `append` 写入一整行 JSON，写入失败不产生半行。
- **状态派生**: 当前状态通过 `derive_state(filename, key_field)` 从全量记录计算得出，不维护单独“当前状态”文件。
## 2. 写入规范
### 2.1 必填字段
每条记录建议包含:
- `ts`: ISO8601 时间戳 (若未提供，由引擎自动补全)
- `op`: 操作类型，如 `task_created`、`status_update`、`income`、`system`
> ... 完整内容见 `skills/it-admin/rules/jsonl-operations.md` (56 行)
# Agent 权限矩阵 (IT Admin)
> 来源: 24-security.md + 08-it-admin-design.md
> JSONL 及共享资源按本矩阵控制读写。
## 1. JSONL 文件权限
| 文件 | CEO | Prod | Biz | 说明 |
|------|-----|------|-----|------|
| events.jsonl | R/W | R/W (append) | R/W (append) | 全量读；写仅 append |
| task-board.jsonl | R/W | R + 状态更新 | R | Prod 仅允许 op=status_update 且 taskId 属于己方 |
| financial.jsonl | R/W | R (自己的) | R (统计) | 仅 CEO 可写 |
| leads.jsonl | R/W | R | R/W | Biz 可新建/更新商机 |
| accounts.jsonl | R | — | R/W | Prod 不可见 |
| compliance-log.jsonl | R/W | R | R | 仅 CEO 可写 |
| crm.jsonl | R/W | R (分配的) | R | 客户数据 |
| quality-metrics.jsonl | R/W | R + append | R | 质检结果 |
## 2. 其他资源
> ... 完整内容见 `skills/it-admin/rules/permission-matrix.md` (43 行)
---
## NEVER (角色特定)
- NEVER 允许 Agent 绕过权限矩阵直接操作文件
严重级别: HIGH
原因: Prod Agent 写入 task-board.jsonl 会导致任务状态混乱
替代: 每次操作前必须检查 data-permission 矩阵 来源: docs/24-security.md §Agent权限
- NEVER 追加 JSONL 时不带 ts 时间戳
严重级别: HIGH
原因: 无时间戳的记录无法排序、审计、做时间范围查询
替代: 每条记录必须有 ISO 格式的 ts 字段 来源: docs/13-data-lifecycle.md
- NEVER 丢弃损坏数据行而不记录日志
严重级别: HIGH
原因: 静默丢弃会导致数据不一致且无法追查原因
替代: 跳过损坏行 + 记录到 events.jsonl + 通知风控经理 来源: docs/skills/08-it-admin-design.md
- NEVER 创建可执行文件
严重级别: HIGH
原因: 安全风险,只允许数据文件和配置文件
替代: 需要执行脚本时由人类操作 来源: docs/24-security.md
---
## L5 触发测试
### 正例
### 反例