Back to Details

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

核心操作

CommandDescription
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

流程步骤

  1. [Step with criteria]
  2. [Step with criteria]
  1. [带有判断标准的步骤]
  2. [带有判断标准的步骤]

Decision Criteria

决策标准

SituationAction
[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

风险等级

TierOperationsApproval
LowRead-only queriesAuto
MediumModificationsConfirm
HighDestructive opsExplicit
等级操作类型审批要求
低只读查询自动审批
中修改操作确认审批
高破坏性操作明确审批

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

工作流阶段

  1. [Phase]: [What happens]
  2. [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

THE EXACT PROMPT

ANALYZE THE FOLLOWING CODE FOR SECURITY VULNERABILITIES:
  1. CHECK FOR HARDCODED SECRETS
  2. IDENTIFY SQL INJECTION RISKS
  3. FLAG INSECURE DEPENDENCIES
RETURN FINDINGS AS JSON WITH SEVERITY LEVELS.
undefined
ANALYZE THE FOLLOWING CODE FOR SECURITY VULNERABILITIES:
  1. CHECK FOR HARDCODED SECRETS
  2. IDENTIFY SQL INJECTION RISKS
  3. 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

验证循环

  1. Execute action
  2. Verify result matches criteria
  3. If FAIL: diagnose → fix → goto 1
  4. If PASS: proceed to next step
Never advance without validation passing.
undefined
  1. 执行操作
  2. 验证结果是否符合标准
  3. 若失败：诊断→修复→回到步骤1
  4. 若成功：进入下一步
未通过验证绝不推进。
undefined