workspace-integrity-guardian

name	workspace-integrity-guardian
version	1.0.0
description	工作空间完整性守护者 - 基于第一性原理的文件系统巡查机制。 核心目标：确保A满意哥专属文件夹结构完整、内容一致、无遗漏。 巡查维度：结构完整性、内容时效性、引用一致性、安全合规性。
author	Satisficing Institute
tags	["integrity","security","governance","first-principles"]
requires	[{"model":"kimi-coding/k2p5"},{"local_tools":["bash","python3"]},{"compliance":["SKILL_MANAGEMENT_RULES.md","FIRST_PRINCIPLES_WORKING_METHOD.md"]}]

工作空间完整性守护者 V1.0

🎯 第一性原理

"任何系统的失效，都始于最基础的元素缺失"

核心洞察:

• 文件夹是信息的"容器"，容器缺失则信息无处存放
• 文件内容的"过时"比"缺失"更隐蔽，危害更大
• 引用的"不一致"会导致决策基于错误信息
• 安全的"漏洞"往往藏在被忽视的角落

守护原则:

1. 结构完整: 所有应有文件夹必须存在
2. 内容时效: 所有文件内容必须反映最新状态
3. 引用一致: 所有引用必须指向正确的位置
4. 安全合规: 所有文件必须符合安全规范

---

📋 巡查维度（4维检查法）

维度1: 结构完整性检查

检查项:

• 所有预定义文件夹是否存在
• 是否有空文件夹（无任何文件）
• 是否有孤立文件（不在任何文件夹中）
• 文件夹命名是否符合规范

标准结构（A满意哥专属文件夹）:

A满意哥专属文件夹/
├── 00_🧭 罗盘指南/          # 必有：使用指南、目录索引
├── 01_🔥今日重点/            # 必有：当日任务、审阅清单
├── 02_✅成果交付/            # 必有：交付物、版本管理
├── 03_💡创意提案/            # 必有：提案流程、待审议
├── 03_🎨视觉资产/            # 可选：视觉设计文件
├── 03_🔄 进行中/             # 必有：任务跟踪
├── 04_📋 计划队列/           # 必有：未来规划
├── 05_📦历史归档/            # 必有：归档规则
├── 06_👥团队成长/            # 必有：成长档案
├── 06_👥 角色专区/           # 必有：角色工作日志
├── 07_📊数据资产/            # 必有：数据管理
└── AI灵魂复刻包V2.0/         # 必有：复刻核心文件

巡查频率: 每日 09:00（晨报生成前）

---

维度2: 内容时效性检查

检查项:

• 日期引用是否过时（如倒计时、状态看板）
• 版本号是否一致（skill版本 vs 实际版本）
• 任务状态是否更新（进行中/已完成）
• 链接是否有效（引用其他文件的路径）

过时内容识别规则:

- 包含"倒计时XX天"且日期超过3天未更新 → 标记过时
- 包含"最后更新：YYYY-MM-DD"且超过7天 → 提示检查
- 任务状态为"进行中"但超过截止日期 → 标记逾期
- 引用路径指向不存在的文件 → 标记失效

巡查频率: 每日 09:00 + 每周六深度检查

---

维度3: 引用一致性检查

检查项:

• 全局目录索引是否反映实际结构
• 文件间的相互引用是否正确
• MEMORY.md中的skill清单是否与实际一致
• 任务清单中的文件路径是否正确

引用类型:

• 内部引用: A满意哥专属文件夹/XX/XX.md
• 跨目录引用: skills/XXX/SKILL.md
• 文档引用: docs/XXX.md
• 记忆引用: MEMORY.md#章节

巡查频率: 每周六

---

维度4: 安全合规性检查

检查项:

• 敏感文件是否有正确的权限设置
• 密码/密钥是否泄露在文本文件中
• 个人身份信息是否妥善脱敏
• 临时文件是否及时清理

敏感文件清单:

• COMMUNICATION_DNA.md（沟通协议，内部）
• AI灵魂复刻包V2.0/（复刻核心，严格管控）
• 专家联系方式（不入系统，由Egbertie保管）

巡查频率: 每日 + 实时告警

---

🔧 巡查执行流程

自动巡查（每日 09:00）

# 1. 结构检查
find "/root/.openclaw/workspace/A满意哥专属文件夹" -type d -empty

# 2. 日期检查
grep -r "2026-03-1[0-4]" --include="*.md" | head -20

# 3. 引用检查
grep -r "A满意哥专属文件夹/" --include="*.md" | grep -v "$(ls)"

# 4. 生成报告

人工复核（每周六 10:00）

1. 查看自动巡查报告
2. 抽查关键文件内容
3. 验证引用路径有效性
4. 确认敏感文件安全
5. 更新全局目录索引

---

📊 巡查报告模板

# 完整性巡查报告 - YYYY-MM-DD

## 巡查概览
- **巡查时间**: HH:MM
- **巡查人**: 满意妞
- **巡查范围**: A满意哥专属文件夹 + 相关引用

## 维度1: 结构完整性
| 检查项 | 状态 | 详情 |
|--------|------|------|
| 所有预定义文件夹存在 | ✅/❌ | |
| 无空文件夹 | ✅/❌ | 发现X个空文件夹 |
| 无孤立文件 | ✅/❌ | |

## 维度2: 内容时效性
| 文件 | 问题 | 严重程度 | 处理建议 |
|------|------|----------|----------|
| XX.md | 日期过时3天 | 🟡 中 | 更新日期 |
| XX.md | 任务已逾期 | 🔴 高 | 更新状态或延期 |

## 维度3: 引用一致性
| 引用位置 | 引用目标 | 状态 | 修复方式 |
|----------|----------|------|----------|
| 文件A.md | 文件B.md | ❌ 失效 | 更新路径 |

## 维度4: 安全合规性
| 检查项 | 状态 | 备注 |
|--------|------|------|
| 敏感文件权限 | ✅ | 正常 |
| 无密码泄露 | ✅ | 正常 |

## 处理行动
- [ ] 修复问题1
- [ ] 修复问题2
- [ ] 更新全局索引

## 预防措施
- 【根据本次问题，提出的预防措施】

---

🚨 异常告警机制

实时告警（立即通知）

触发条件:

• 发现敏感文件权限变更
• 检测到密码/密钥泄露
• 核心文件夹被删除

通知方式:

• 主通道：Kimi Claw（即时消息）
• 第二通道：飞书（紧急情况）

日报告警（每日09:30）

触发条件:

• 发现空文件夹
• 发现过时内容（>3天）
• 发现失效引用

通知方式:

• 晨报中附带完整性报告摘要

---

🛡️ 预防措施

预防1: 结构保护

• 文件夹创建时: 必须同时创建README.md（即使是空的说明）
• 文件夹删除时: 需确认无重要文件，并记录原因
• 新增文件夹时: 同步更新全局目录索引

预防2: 内容保鲜

• 日期引用: 使用动态计算（如"距离官宣还有${days}天"）
• 状态更新: 任务完成/变更时，立即更新相关文件
• 版本管理: 修改文件时，同步更新版本号和更新日志

预防3: 引用管理

• 路径规范: 统一使用相对路径，避免硬编码
• 索引同步: 任何结构调整后，立即更新01_INDEX
• 链接检查: 新增引用时，验证目标是否存在

预防4: 安全加固

• 敏感文件: 标记并设置特殊权限
• 定期审计: 每月检查敏感文件访问日志
• 泄露响应: 一旦发现泄露，立即轮换相关密钥

---

📁 文件位置

skills/workspace-integrity-guardian/
├── SKILL.md                    # 本文件
├── _meta.json                  # 元数据
├── scripts/
│   ├── check_structure.sh      # 结构检查脚本
│   ├── check_timeliness.py     # 时效检查脚本
│   ├── check_references.py     # 引用检查脚本
│   └── check_security.sh       # 安全检查脚本
└── templates/
    └── inspection_report.md    # 巡查报告模板

---

📝 版本更新日志

v1.0.0 (2026-03-14)

• 创建: 初始版本
• 功能: 4维检查法（结构/时效/引用/安全）
• 机制: 自动巡查 + 人工复核 + 异常告警

---

基于第一性原理构建
版本: v1.0.0
生效: 2026-03-14