用途
Workspace Autopsy & Governance Restructure 是一个智能体技能,用于对现有、可能杂乱的工作区目录进行系统性“解剖”分析,提出合理的新目录结构,并在迁移工作区的同时建立新的治理标准。
主要能力
该技能围绕四个阶段展开:
阶段一:工作区解剖(映射) 运行解剖脚本以映射目录:
python /Users/4jp/.agents/skills/workspace-autopsy-governance/scripts/workspace_autopsy.py --dir .
查看生成的映射与统计信息,识别:核心源代码所在位置;文档、脚本与资产当前散落的位置;需要清理的遗留文件夹或结构性混乱。
阶段二:发送信号(重组提案) 在移动任何文件之前,先向用户“发送信号”,提出新结构与治理方案。读取 assets/RESTRUCTURE_PROPOSAL-template.md 模板,根据解剖发现起草定制化的 RESTRUCTURE_PROPOSAL.md,详细说明将创建哪些目录、哪些文件将迁移到何处。向用户展示该提案并等待其明确批准,未获批准不得进入阶段三。
阶段三:在新位置下统一(迁移) 用户批准提案后:创建提案中约定的新目标目录(例如 /src、/docs、/scripts、/assets、/tests);使用标准 shell 命令(mv)将文件从旧位置系统性地迁移到新建的统一位置;确保混乱的根目录位置不残留孤立文件,除非它们是标准配置文件(例如 .gitignore、package.json)。
阶段四:建立新治理 文件就位后,建立后续管理规则。读取 assets/GEMINI-template.md 模板,根据新重组项目的具体标准、工作流与约束进行定制,将定制后的治理文档写入项目根目录的 GEMINI.md。如合适,可创建子目录专属的 GEMINI.md 以实现更深层治理(例如 /src/GEMINI.md)。
使用方式
按上述四个阶段顺序执行。阶段一通过命令行运行 Python 脚本;阶段二与阶段四依赖 assets 目录中的两个 Markdown 模板;阶段三使用 mv 命令完成迁移。整个流程要求在每个关键节点(尤其是迁移前)获得用户批准。
适用场景
适用于工作区目录结构混乱、文件散落、存在遗留文件夹,需要一次性梳理并建立长期目录规范与治理规则的项目。
限制
资料未提供该技能对特定操作系统、Python 版本或权限的要求;未说明脚本对符号链接、隐藏文件或超大目录的处理方式;未提供收费、价格或平台支持信息。