work-organizer SKILL.md skillA

work-organizer from skyzhao1223/zspace-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add skyzhao1223/zspace-cli/work-organizer@git:20261009.f321c25

Pins git:20261009.f321c25 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
skyzhao1223/zspace-cli
Path
src/zspace_cli/skills/work-organizer/SKILL.md
Versions recorded
4
Latest version
git:20261009.f321c25, committed Oct 9, 2026
First version recorded
Sep 20, 2026
Size
21,780 bytes
Repository stars
27
License
MIT

Use when 用户想整理 NAS 上的工作文件 — "帮我整理工作目录"、"根目录一堆散文件"、"文档版本太乱(最终版/final/副本)"、"找临时文件和安装包"、"几年没动的文件归档"、"办公文档按项目/年份归位"。只读扫描(scan)找出根目录散文件、版本标记混乱、同名多版本共存、副本、临时/锁定文件、安装包、过期归档候选;LLM 出 old→new 计划,用户确认后由 Agent 执行。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Work Organizer — 工作文件库正向合规整理

## 概述

**跨 NAS 通用**:扫描脚本跑在**本地挂载路径**上(SMB/NFS 挂载的 NAS 共享、
外置硬盘、本地同步目录都行),纯 stdlib 零依赖,不绑定任何品牌 API。

对工作文件库做**正向合规扫描**:定义合规结构(年份/项目 + 规范命名)→ 不匹配即报问题。
**写操作不在脚本里** — 扫描出问题后,LLM 生成 `old → new` 整理计划,
经用户确认后由 Agent 执行(挂载盘 `mkdir`/`mv -n`,极空间也可走 `zs` CLI / MCP tool)。

## Prerequisites

```bash
# macOS 挂载 NAS 共享(Finder → 前往 → 连接服务器)
open smb://<NAS_IP>/工作        # 极空间/群晖/威联通/绿联等均支持 SMB
# 挂载后路径形如 /Volumes/工作

python3 --version               # ≥3.9 即可,无第三方依赖
```

## 快速验证

```bash
python3 work_organizer.py scan --root /Volumes/nas/工作 --sample 200
```

## 命令

| 命令 | 用途 |
|------|------|
| `scan --root PATH` | 正向合规扫描(只读) |
| `scan --root PATH --json --output F` | JSON 输出 |
| `--strict-naming` | 加查:办公文档需带日期前缀 `YYYYMMDD_` |
| `--archive-years N` | 加查:mtime 超过 N 年 → 归档候选(默认关) |
| `--max-depth N` / `--sample N` / `--top N` | 深度 / 文件数上限 / 每类显示条数 |
| (同目录 `config.json`) | 可选覆盖层:目录白名单 + 扩展名改判,见下「配置覆盖」。**没有这个文件时行为与旧版逐字节一致** |

期望目录结构:

```
工作/
  2024/                                    ← 年份
    官网改版/                              ← 项目
      20240501_官网改版_需求文档_v2.docx    ← 日期_项目_主题_vN
      20240515_官网改版_设计稿_v1.pdf
  合同/                                    ← 职能目录(白名单)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add skyzhao1223/zspace-cli/work-organizer@sha256:27004f349af7adef

The line at the top of this page pins the label git:20261009.f321c25, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jxe3qm74gtb3snt4.svg)](https://markdownregistry.com/a/art_jxe3qm74gtb3snt4)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 20, 2026 and Oct 9, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261009.f321c25 latest2026-10-09 f321c25 21,780 BA view · diff
git:20261008.aae65c72026-10-08 aae65c7 8,691 BA view · diff
git:20261008.a310beb2026-10-08 a310beb 8,180 BA view · diff
git:20260920.d4bf53a2026-09-20 d4bf53a 8,120 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (21780 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

skyzhao1223/zspace-cli · 27 stars · license MIT · pushed 2026-10-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jxe3qm74gtb3snt4
GET https://markdownregistry.com/api/v1/resolve?ref=skyzhao1223/zspace-cli/work-organizer
GET https://markdownregistry.com/api/v1/blob/27004f349af7adef4911b7833a4d41615d199fd572e4621d37cfaf0633487183

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from skyzhao1223/zspace-cli

backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars
download-cleaner SKILL.md skill
skyzhao1223/zspace-cli · skills/download-cleaner/SKILL.md · Use when 用户想清理 NAS 下载目录 — "下载区太乱帮我清一下"、"哪些下载可以删了"、"安装包/种子/压缩包占空间"、"下载完的视频没归档"、"半截下载残留"、"重复下载了好几次"。只读扫描按类别分诊(未完成/种子/安装包/压…
git:20261009.88e9b2f · audit A · 27 stars
file-sorter SKILL.md skill
skyzhao1223/zspace-cli · skills/file-sorter/SKILL.md · Use when 用户想给 NAS 上一个「什么都往里丢」的乱目录做分类归档 — "帮我把文件分个类"、"图纸和文档混在一起"、"根目录一堆散文件"、"按类型建目录归档"、"dwg/pdf/图片全堆在一层"、"外置盘拷进来一堆东西没整理"。…
git:20261008.f01b099 · audit A · 27 stars
music-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/music-organizer/SKILL.md · Use when 用户想整理 NAS 上的音乐库 — "帮我整理音乐"、"歌曲散落一地"、"专辑没有封面"、"文件名带【FLAC】/320K 水印"、"曲目没有编号"、"路径和 ID3…
git:20261009.f321c25 · audit A · 27 stars
nas-report SKILL.md skill
skyzhao1223/zspace-cli · skills/nas-report/SKILL.md · Use when 用户想给 NAS 做整体存储体检 — "我 NAS 上都存了些啥"、"空间被什么占了"、"帮我做个存储报告"、"哪些数据该归档/清理"、"该用哪个整理…
git:20261008.f01b099 · audit A · 27 stars
photo-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/photo-organizer/SKILL.md · Use when 用户想整理 NAS/移动硬盘上的照片视频 — "帮我整理照片库"、"手机备份的照片太乱"、"截图和微信图片按日期归档"、"DCIM/IMG…
git:20261009.a9a41aa · audit A · 27 stars
portfolio-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/portfolio-organizer/SKILL.md · Use when 用户想整理 NAS 上的作品集 — "帮我整理作品集"、"设计项目文件太乱"、"源文件和成品混在一起"、"项目缺封面/说明"、"成品版本太多不知道哪个是最终版"、"大体积…
git:20261009.34b1347 · audit A · 27 stars
work-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/work-organizer/SKILL.md · Use when 用户想整理 NAS 上的工作文件 — "帮我整理工作目录"、"根目录一堆散文件"、"文档版本太乱(最终版/final/副本)"、"找临时文件和安装包"、"几年没动的文件归档"、"办公文档按项目/年份归位"。只读扫描(sca…
git:20261009.f321c25 · audit A · 27 stars
zspace-nas SKILL.md skill
skyzhao1223/zspace-cli · skills/zspace-nas/SKILL.md · Manage files on ZSpace (极空间) NAS through zspace-cli Python SDK and CLI. List, rename, move, copy, remove, search, and…
git:20261009.f7254dc · audit B · 27 stars
backup-auditor SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/backup-auditor/SKILL.md · Use when 用户想审计 NAS 上的备份 — "我的备份还新鲜吗"、"备份作业是不是挂了"、"哪些旧备份可以轮转删掉"、"关键目录都有备份吗"、"有没有孤儿备份/空备份"。只读审计:scan…
git:20261009.86c2bf8 · audit A · 27 stars
dedup-finder SKILL.md skill
skyzhao1223/zspace-cli · src/zspace_cli/skills/dedup-finder/SKILL.md · Use when 用户想找 NAS 上的重复文件 — "哪些文件重复了"、"帮我找重复照片/视频/文档"、"磁盘被重复文件占满了"、"下载了好几次同一个东西"、"精确去重不要误删"。只读扫描用三级指纹(size → 头部64KB → 全量…
git:20261009.657293a · audit A · 27 stars

Every file in skyzhao1223/zspace-cli

Other files named work-organizer

work-organizer SKILL.md skill
skyzhao1223/zspace-cli · skills/work-organizer/SKILL.md · Use when 用户想整理 NAS 上的工作文件 — "帮我整理工作目录"、"根目录一堆散文件"、"文档版本太乱(最终版/final/副本)"、"找临时文件和安装包"、"几年没动的文件归档"、"办公文档按项目/年份归位"。只读扫描(sca…
git:20261009.f321c25 · audit A · 27 stars

Browse by kind, by grade A, or by owner.