skill-archetypes

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Archetypes

Skill原型

Identify which archetype fits best and follow its structure.

确定最适合的原型并遵循其结构。

1. CLI Reference Skill

1. CLI参考型Skill

For tools, CLIs, APIs. Structure by operations, minimize prose.

markdown

undefined

适用于工具、CLI、API。按操作分类，尽量减少冗余文字。

markdown

undefined

Authentication

身份验证

[How to authenticate]

[身份验证方法]

Core Operations

核心操作

Command	Description
`tool init`	Initialize project
`tool run`	Execute task

命令	描述
`tool init`	初始化项目
`tool run`	执行任务

Common Workflows

常见工作流

[Task-oriented examples]


**Examples:** `kamal-coder`, `wrangler-coder`, `gh-cli`

[面向任务的示例]


**示例：** `kamal-coder`、`wrangler-coder`、`gh-cli`

2. Methodology Skill

2. 方法论型Skill

For development practices, workflows, philosophies.

markdown

undefined

适用于开发实践、工作流、理念。

markdown

undefined

Core Philosophy

核心理念

[Why this approach matters - 2-3 sentences max]

[该方法的重要性——最多2-3句话]

The Process

流程步骤

[Step with criteria]
[Step with criteria]

[带有判断标准的步骤]
[带有判断标准的步骤]

Decision Criteria

决策标准

Situation	Action
[condition]	[response]


**Examples:** `tdd-workflow`, `dhh-coder`, `founder-mode`

场景	操作
[条件]	[响应]


**示例：** `tdd-workflow`、`dhh-coder`、`founder-mode`

3. Safety/Security Skill

3. 安全/合规型Skill

For operations with risk. Include tiered approvals.

markdown

undefined

适用于存在风险的操作。包含分级审批机制。

markdown

undefined

Risk Tiers

风险等级

Tier	Operations	Approval
Low	Read-only queries	Auto
Medium	Modifications	Confirm
High	Destructive ops	Explicit

等级	操作类型	审批要求
低	只读查询	自动审批
中	修改操作	确认审批
高	破坏性操作	明确审批

Blocking Patterns

禁止操作模式

[What to never do]

[绝对不能执行的操作]

Allowing Patterns

允许操作模式

[Safe operations]


**Examples:** `infra-security-review`, `devops-verifier`

[安全操作示例]


**示例：** `infra-security-review`、`devops-verifier`

4. Orchestration Skill

4. 编排型Skill

For multi-step processes that coordinate other tools.

markdown

undefined

适用于协调其他工具的多步骤流程。

markdown

undefined

Quick Start

快速开始

[Minimal invocation]

[最简调用方式]

Workflow Phases

工作流阶段

[Phase]: [What happens]
[Phase]: [What happens]

Machine-Readable Output

机器可读输出

[JSON/YAML schema for automation]


**Examples:** `build-task-workflow`, `quality-gate`

[用于自动化的JSON/YAML schema]


**示例：** `build-task-workflow`、`quality-gate`

Advanced Patterns

进阶模式

THE EXACT PROMPT Pattern

精确提示（THE EXACT PROMPT）模式

For reproducible agent-to-agent handoffs, encode prompts in ALL CAPS:

markdown

undefined

为实现可复现的Agent间交接，将提示语用全大写格式编码：

markdown

undefined

THE EXACT PROMPT

ANALYZE THE FOLLOWING CODE FOR SECURITY VULNERABILITIES:

CHECK FOR HARDCODED SECRETS
IDENTIFY SQL INJECTION RISKS
FLAG INSECURE DEPENDENCIES

RETURN FINDINGS AS JSON WITH SEVERITY LEVELS.

undefined

ANALYZE THE FOLLOWING CODE FOR SECURITY VULNERABILITIES:

CHECK FOR HARDCODED SECRETS
IDENTIFY SQL INJECTION RISKS
FLAG INSECURE DEPENDENCIES

RETURN FINDINGS AS JSON WITH SEVERITY LEVELS.

undefined

Checklist Pattern

检查清单模式

For multi-step processes with progress tracking:

markdown

undefined

适用于需要进度跟踪的多步骤流程：

markdown

undefined

Checklist

检查清单

Step 1: [Action with success criteria]
Step 2: [Action with success criteria]
Step 3: [Action with success criteria]

Mark each complete before proceeding.

undefined

步骤1：[带有成功标准的操作]
步骤2：[带有成功标准的操作]
步骤3：[带有成功标准的操作]

完成每项后再进行下一步。

undefined

Feedback Loop Pattern

反馈循环模式

For operations requiring validation:

markdown

undefined

适用于需要验证的操作：

markdown

undefined

Validation Loop

验证循环

Execute action
Verify result matches criteria
If FAIL: diagnose → fix → goto 1
If PASS: proceed to next step

Never advance without validation passing.

undefined

执行操作
验证结果是否符合标准
若失败：诊断→修复→回到步骤1
若成功：进入下一步

未通过验证绝不推进。

undefined