Agent 生成器

Name: Agent 生成器
Author: cat-xierluo

AI 智能已审计 v1.4.0

作者仓库星标 248
许可证 CC BY-NC-SA 4.0 - 详见 LICENSE.txt
作者更新于实时读取
作者仓库 legal-skills

流狐档案事实层信息：领域、Agent、信任分、运行环境、权限与网络

领域: AI 智能
兼容 Agent: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
信任分: 98 / 100 · 已通过审计
作者 / 版本 / 许可: @cat-xierluo · v1.4.0 · CC BY-NC-SA 4.0 - 详见 LICENSE.txt
Token 消耗评级: 低消耗
接入复杂程度: 需简单配置
是否需要外部 API Key: 不需要
兼容的系统: 未声明（默认跨平台）
底层运行要求: Python
文件与系统权限: 只读
允许写入 / 修改
Shell 执行
读取环境变量
网络行为: 仅限本地
安装命令数: 26 条

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 skill-architect-cat-xierluo.preview

---
name: skill-architect
description: 技能架构师向导与审查工具，整合官方 skill-creator 流程与内置合规检查。本技能应在用户需要创建新技能、编辑现有技能、打包技能、同步 Frontmatter 发布规范、或审查现有技能…
category: AI 智能
runtime: Python
---

# skill-architect 输出预览

## PART A: 任务判断
- 适用问题：提示词、Agent 工作流、模型评估或自动化推理。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“使用模式 / 模式一：创建模式 / 模式二：审查模式”读取原文规则，不把推断写成作者承诺。

## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于提示词、Agent 工作流、模型评估或自动化推理，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“使用模式 / 模式一：创建模式 / 模式二：审查模式”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、执行终端命令、读取环境变量、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。

## Running Rules
- 读取文件、写入/修改文件、执行终端命令、读取环境变量；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。

SKILL.md SKILL.md

---
name: skill-architect
description: 技能架构师向导与审查工具，整合官方 skill-creator 流程与内置合规检查。本技能应在用户需要创建新技能、编辑现有技能、打包技能、同步 Frontmatter 发布规范、或审查现有技能…
category: AI 智能
source: cat-xierluo/legal-skills
---

# skill-architect

## 什么时候使用
- 用于创建、审计和维护 Agent Skill / SKILL 适合处理AI Agent、提示词、模型评估与自动化推理，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭…
- 面向提示词、Agent 工作流、模型评估或自动化推理，优先处理能明确输入、步骤和验收标准的工作。

## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。

## 执行规则
- 围绕「使用模式 / 模式一：创建模式 / 模式二：审查模式」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令、读取环境变量；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。

## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。

证据边界与执行链路

作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。

skill "skill-architect" {
  输入层     -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
  上下文层   -> 使用模式 / 模式一：创建模式 / 模式二：审查模式
  规则层     -> SKILL.md 触发条件 / 执行顺序 / 输出格式
  运行层     -> Python | 读取文件、写入/修改文件、执行终端命令、读取环境变量 | 主要在本地完成
  安全层     -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
  输出层     -> 可复制结果 + 检查清单 + 下一步迭代
}

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

先判断是否适合

核心用途：用于创建、审计和维护 Agent Skill / SKILL 适合处理AI Agent、提示词、模型评估与自动化推理，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要…
适用任务：更适合 AI Agent、提示词、模型评估与自动化推理，尤其是输入、步骤、验收口径可以反复复用的场景。
不宜硬套：如果任务只有一次性问答、来源材料很少，或需要作者没有说明的命令和外部服务，应先降级为普通对话。

作者设计意图

触发依据：使用时机、上下文收集、输出格式和失败处理共同决定它是否适合当前任务。
来源边界：作者原文负责事实，仓库文件负责命令和文件证据；Fluxly 只补充用途、限制和使用判断。

作者的方法与取舍

执行主线：任务围绕「使用模式 / 模式一：创建模式 / 模式二：审查模式」组织，把触发条件、必要上下文、执行规则和交付标准连成一条可复核的链路。
设计重点：重点不在重复教程，而在解释作者为什么规定这些步骤、哪些条件不可省略，以及结果偏离时应回到哪一层检查。
使用判断：先确认任务与原文边界一致，再决定是否启用；来源没有说明的命令、平台和依赖保持未知，不由 Fluxly 补写。

边界和复核

依赖条件：通常不需要额外 API Key，适合先用小任务验证触发是否稳定。
权限提醒：会涉及 read / write / shell-exec / env-read 权限，执行前要说明可读写范围、命令边界和回退方式。
质量标准：结果应包含明确产物、必要证据和下一步动作；如果只是泛泛解释，需要补充输入和验收条件后重跑。

Skill Architect

基于官方 skill-creator 的增强版技能架构师向导，内置合规检查规则，支持两种使用模式：

使用模式

模式一：创建模式

创建新技能时使用，遵循以下流程：

理解技能需求（收集具体示例）
规划可复用资源（scripts/, references/, assets/）
初始化技能（创建目录结构）
编辑技能（实现资源 + 编写 SKILL.md）
合规性检查（内置检查规则）
迭代（基于使用反馈改进）

模式二：审查模式

审查现有技能的合规性时使用：

指定要审查的技能路径
扫描目录结构和文件
按检查清单逐项审查
生成结构化审查报告

模式一：创建模式

Step 1: 理解技能需求

跳过此步骤的条件：技能的使用模式已经非常清晰。

收集具体的使用示例：

"这个技能应该支持什么功能？"
"能给一些具体的使用场景吗？"
"用户会说什么话来触发这个技能？"

完成标准：清楚知道技能的功能边界和触发场景。

Step 2: 规划可复用资源

分析每个使用场景，确定需要的资源：

资源类型

类型	目录	用途	何时需要
脚本	`scripts/`	可执行代码	同一代码反复重写时
参考	`references/`	详细文档	需要 schema/API 文档时
资产	`assets/`	输出模板	需要模板/图标/字体时

依赖规划

如果技能包含脚本，在此步骤中梳理依赖关系：

列出所有外部依赖：区分硬依赖（缺了就跑不了）和可选依赖（增强功能）
规划降级策略：
- 硬依赖：try/except + 安装提示 + 退出
- 可选依赖：try/except + 功能标志 + 静默降级
准备 requirements.txt：只包含硬依赖
规划 SKILL.md 说明位置：在需要依赖的功能章节内就近放置安装说明

目录结构规范

创建时遵循以下结构：

skill-name/
├── SKILL.md          # 必需 - 主文档
├── LICENSE.txt       # 推荐 - 许可证
├── references/       # 可选 - 参考文档
├── scripts/          # 可选 - 可执行脚本
└── assets/           # 可选 - 输出资源

禁止创建：

README.md - 与 SKILL.md 重复
docs/ - 应使用 references/
test/ - 开发文件不应在发布版中
__pycache__/ - Python 缓存不应提交
.env - 敏感配置不应提交

Step 3: 初始化技能

创建技能目录和基础文件：

创建技能目录 <skill-name>/
创建 SKILL.md 并添加 frontmatter
创建 LICENSE.txt（推荐）
创建需要的子目录（scripts/, references/, assets/）

Step 4: 编辑技能

4.1 Frontmatter 规范

---
name: skill-name                    # 小写字母 + 连字符
description: 本技能应在用户需要...时使用。不要用于：...  # 第三人称 + 触发边界
version: "1.0.0"                   # 与 CHANGELOG 最新版本一致
license: MIT                       # 或 CC-BY-NC
author: 杨卫薪律师（微信ywxlaw）
homepage: https://github.com/cat-xierluo/legal-skills
---

description 写作要求：

使用第三人称："本技能应在...时使用"
包含触发场景：明确说明何时使用
包含负向触发条件："不要用于..."说明边界
长度控制在 1024 字符以内
不要在 SKILL.md 正文中添加"何时使用"章节

发布字段要求：

version 是公开发布推荐字段；如存在，必须与 CHANGELOG.md 最新版本一致
CHANGELOG.md 仍是完整版本历史来源
homepage 推荐保留；已有 homepage 时不强制 source

4.2 SKILL.md 内容规范

保持简洁：

避免大段代码（>20 行应移至 scripts/）
使用简洁示例，仅展示关键 API 调用
聚焦工作流程，说明"做什么"和"怎么做"

Progressive Disclosure：

核心流程在 SKILL.md 正文中
详细文档放在 references/ 中
在 SKILL.md 中引用 references 文件

4.3 配置文件规范

命名规则：

类型	格式	是否提交
模板文件	`.example.`	提交
实际配置	`*`	被 .gitignore 忽略

示例：

config.example.yaml → 提交
config.yaml → 忽略
.env.example → 提交
.env → 忽略

4.4 输出模式规范

对于需要一致性输出的技能，提供输出格式指导。

严格模式（API 响应、数据格式）：

ALWAYS use this exact template structure:

# [Analysis Title]

## Executive summary
[One-paragraph overview]

## Key findings
- Finding 1 with supporting data
- Finding 2 with supporting data

灵活模式（分析报告、创意内容）：

Here is a sensible default format, but use your best judgment:

# [Analysis Title]

## Executive summary
[Overview]

Adjust sections as needed for the specific context.

4.5 工作流模式规范

顺序工作流：

Filling a PDF form involves these steps:

1. Analyze the form (run analyze_form.py)
2. Create field mapping (edit fields.json)
3. Validate mapping (run validate_fields.py)
4. Fill the form (run fill_form.py)

条件工作流：

1. Determine the modification type:
   **Creating new content?** → Follow "Creation workflow" below
   **Editing existing content?** → Follow "Editing workflow" below

2. Creation workflow:
   - Step 1: ...
   - Step 2: ...

4.6 技能协作规范

松耦合原则：

用自然语言描述协作场景
说明技能"做什么"和"如何配合"
不直接引用其他技能的内部脚本路径
不在代码中 import 其他技能的模块

推荐写法：

## 与其他技能配合

下载的视频可以使用 FunASR 技能转录为带时间戳的 Markdown 文件。
两个技能独立运行，可根据需要灵活组合使用。

避免写法：

## 与其他技能配合

转录时运行：
python ../../skills/funasr-transcribe/scripts/transcribe.py

4.7 可编排性设计

对于可能参与复杂工作流编排的技能：

输入/输出声明：

## 输入/输出

### 输入
- 必需：`--input` 参数说明
- 可选：`--flag` 参数说明

### 输出
- 输出文件：`output/path.md` 说明
- 副作用：如创建目录、修改文件等

单一职责：

技能只做一件事
避免多任务混合

幂等性：

多次执行结果相同
无累积效应

Step 5: 合规性检查

打包前，按以下检查清单逐项检查：

5.1 目录结构

检查项	状态
SKILL.md 存在	✅/❌
无 README.md	✅/⚠️
无 docs/ 目录	✅/⚠️
无 test/ 目录	✅/⚠️
无 pycache/	✅/❌
无 .env 文件	✅/❌

5.2 Frontmatter

检查项	状态
name 字段存在且格式正确	✅/❌
description 字段存在	✅/❌
description 使用第三人称	✅/❌
description 包含负向触发条件	✅/⚠️
description 长度 ≤ 1024 字符	✅/❌
version 与 CHANGELOG 最新版本一致	✅/⚠️
homepage/author/license 推荐字段完整	✅/⚠️

5.3 SKILL.md 行数

检查项	状态
SKILL.md 行数 ≤ 500 行	✅/⚠️

5.4 目录层级

检查项	状态
references/ 扁平结构（一级）	✅/⚠️
scripts/ 扁平结构（一级）	✅/⚠️
assets/ 扁平结构（一级）	✅/⚠️

5.5 文档一致性

检查项	状态
引用的脚本文件存在	✅/❌
引用的参考文档存在	✅/❌
引用的资源文件存在	✅/❌

5.6 配置文件

检查项	状态
模板使用 .example. 命名	✅/⚠️
example 字段与代码匹配	✅/❌

5.7 技能协作

检查项	状态
不直接引用其他技能路径	✅/⚠️
使用自然语言描述协作	✅/⚠️

5.8 模块化设计

检查项	状态
独立功能解耦到单独脚本	✅/⚠️
跨 skill 不直接调用内部脚本	✅/⚠️

5.9 安全审计

检查项	状态
无硬编码 API keys	✅/❌
无危险删除命令（rm -rf ~ 等）	✅/❌
删除命令使用安全方式	✅/⚠️

5.10 依赖声明与防护

检查项	状态
SKILL.md 声明了依赖（区分开箱即用 vs 需安装功能）	✅/⚠️
脚本硬依赖有 try/except + 安装提示	✅/❌
脚本可选依赖有 try/except + 降级标志	✅/⚠️
requirements.txt 只包含硬依赖	✅/⚠️
依赖安装说明就近放置（对应功能章节内）	✅/⚠️

问题严重程度：

级别	说明	处理
❌ 严重	阻塞技能正常使用	必须修复
⚠️ 警告	影响可维护性	建议修复

Step 6: 迭代

基于实际使用反馈改进技能：

使用技能处理真实任务
发现困难或效率问题
更新 SKILL.md 或相关资源

模式二：审查模式

审查现有技能的合规性，生成结构化审查报告。

审查流程

指定目标 - 提供要审查的技能路径
扫描文件 - 列出技能目录所有文件
逐项检查 - 按检查清单审查（使用 Step 5 相同规则）
生成报告 - 输出结构化审查结果

审查报告格式

# [skill-name] 格式审查报告

**审查时间**: YYYY-MM-DD HH:MM
**技能路径**: /path/to/skill

## 审查摘要

| 检查项 | 状态 | 问题数 |
|--------|------|--------|
| 目录结构 | ✅/⚠️/❌ | N |
| Frontmatter | ✅/⚠️/❌ | N |
| SKILL.md 行数 | ✅/⚠️ | N |
| 目录层级 | ✅/⚠️ | N |
| 文档一致性 | ✅/⚠️/❌ | N |
| 配置文件 | ✅/⚠️/❌ | N |
| 技能协作 | ✅/⚠️/❌ | N |
| 模块化设计 | ✅/⚠️ | N |
| 安全审计 | ✅/❌ | N |

## 详细问题

### ❌ 严重问题（必须修复）

1. **[问题标题]**
   - 位置: `文件路径:行号`
   - 规范: 违反的规范条款
   - 建议: 修复建议

### ⚠️ 建议优化

1. **[问题标题]**
   - 位置: `文件路径`
   - 建议: 优化建议

## 审查完成

- 总问题数: N
- 严重问题: N
- 建议优化: N

审查执行方式

使用 Glob 列出技能目录所有文件
使用 Read 读取 SKILL.md 和关键文件
按 Step 5 检查清单逐项审查
生成结构化审查报告

规范参考

详细规范标准见 references/skill-standards.md

安装命令

一键复制安装选择包管理器,点击右侧复制,粘贴到终端回车即可

npx skills add cat-xierluo/legal-skills/skills/skill-architect -y

查看通用安装教程

查看 Skill 原文

兼容工具

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

安全审计

98 / 100

已审计

未限定 allowed-tools，默认拥有全部工具权限。

元信息

来源: github
cat-xierluo/legal-skills
版本: 1.4.0
许可证: CC BY-NC-SA 4.0 - 详见 LICENSE.txt
English

@cat-xierluo 的其他技能

分类与标签

分类 AI 智能

先判断是否适合

作者设计意图

作者的方法与取舍

边界和复核

Skill Architect

使用模式

模式一：创建模式

模式二：审查模式

模式一：创建模式

Step 1: 理解技能需求

Step 1: 理解技能需求

Step 2: 规划可复用资源

资源类型

依赖规划

目录结构规范

Step 3: 初始化技能

Step 4: 编辑技能

4.1 Frontmatter 规范

4.2 SKILL.md 内容规范

4.3 配置文件规范

4.4 输出模式规范

4.5 工作流模式规范

4.6 技能协作规范

4.7 可编排性设计

Step 5: 合规性检查

5.1 目录结构

5.2 Frontmatter

5.3 SKILL.md 行数

5.4 目录层级

5.5 文档一致性

5.6 配置文件

5.7 技能协作

5.8 模块化设计

5.9 安全审计

5.10 依赖声明与防护

Step 6: 迭代

模式二：审查模式

审查流程

审查报告格式

审查执行方式

规范参考

讨论