Token导航 LogoToken导航TokenDH.com
研究检索external-servicegithub未标认证来源可访问许可证需确认审计提醒

agent-native-architectureAgent 本机架构

Agent Skill

agent-native-architecture 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

245

周安装

10

GitHub Stars

7

下载量

79
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:agent-native-architecture(Agent 本机架构)
来源仓库:https://github.com/iliaal/ai-skills
仓库路径:skills/agent-native-architecture
安装命令:
npx skills add https://github.com/iliaal/ai-skills --skill agent-native-architecture
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/iliaal/ai-skills --skill agent-native-architecture

简介

agent-native-architecture 用于查找、检索和筛选相关信息。

  • 适合在 Codex、Claude、Cursor、Gemini CLI 中根据关键词或任务场景快速定位候选结果。
  • 可通过 npx skills add 命令从指定仓库安装并使用该技能。
  • 安装前建议确认权限范围、维护状态,以及是否会触发联网或文件读写操作。
  • 可结合来源仓库和原始 README 进一步核验具体用法和功能边界。

SKILL.md

Agent-Native Architecture

Core Principles

Five principles govern agent-native design. For detailed explanations, examples, and test criteria, see core-principles.md.

PrincipleOne-line test
ParityCan the agent achieve every outcome the UI allows?
GranularityTo change behavior, do you edit prose or refactor code?
ComposabilityCan you add a feature by writing a new prompt, without new code?
Emergent CapabilityCan the agent handle open-ended requests you didn't design for?
Improvement Over TimeDoes the app work better after a month, even without code changes?

Focus Area Selection

  1. Design architecture - Plan a new agent-native system from scratch
  2. Files & workspace - Use files as the universal interface, shared workspace patterns
  3. Tool design - Build primitive tools, dynamic capability discovery, CRUD completeness
  4. Domain tools - Know when to add domain tools vs stay with primitives
  5. Execution patterns - Completion signals, partial completion, context limits
  6. System prompts - Define agent behavior in prompts, judgment criteria
  7. Context injection - Inject runtime app state into agent prompts
  8. Action parity - Ensure agents can do everything users can do
  9. Self-modification - Enable agents to safely evolve themselves
  10. Product design - Progressive disclosure, latent demand, approval patterns
  11. Mobile patterns - iOS storage, background execution, checkpoint/resume
  12. Testing - Test agent-native apps for capability and parity
  13. Refactoring - Make existing code more agent-native
  14. Anti-patterns - Common mistakes and how to avoid them
  15. Success criteria - Verify your architecture is agent-native
  16. Hooks patterns - Hook events, decision control, MCP matchers, async hooks

Wait for response before proceeding.

Reference Routing

ResponseAction
1, "design", "architecture", "plan"Read architecture-patterns.md, then apply Architecture Checklist below
2, "files", "workspace", "filesystem"Read files-universal-interface.md and shared-workspace-architecture.md
3, "tool", "mcp", "primitive", "crud"Read mcp-tool-design.md
4, "domain tool", "when to add"Read from-primitives-to-domain-tools.md
5, "execution", "completion", "loop"Read agent-execution-patterns.md
6, "prompt", "system prompt", "behavior"Read system-prompt-design.md
7, "context", "inject", "runtime", "dynamic"Read dynamic-context-injection.md
8, "parity", "ui action", "capability map"Read action-parity-discipline.md
9, "self-modify", "evolve", "git"Read self-modification.md
10, "product", "progressive", "approval", "latent demand"Read product-implications.md
11, "mobile", "ios", "android", "background", "checkpoint"Read mobile-patterns.md
11a, "icloud", "storage", "documents", "file state", "entitlement"Read mobile-storage.md
11b, "background task", "battery", "on-device", "cloud routing"Read mobile-execution.md
11c, "model tier", "token budget", "cost-aware", "batch", "caching"Read mobile-cost.md
12, "test", "testing", "verify", "validate"Read agent-native-testing.md
13, "review", "refactor", "existing"Read refactoring-to-prompt-native.md
14, "anti-pattern", "mistake", "wrong"Read anti-patterns.md
15, "success", "criteria", "verify", "checklist"Read success-criteria.md
16, "hook", "hooks", "PreToolUse", "decision control", "async hook"Read hooks-patterns.md
0, "quick start", "getting started", "overview", "introduction"Read quick-start.md

After reading the reference, apply those patterns to the user's specific context.

Architecture Review Checklist

When designing an agent-native system, verify these before implementation:

Core Principles

  • Parity: Every UI action has a corresponding agent capability
  • Granularity: Tools are primitives; features are prompt-defined outcomes
  • Composability: New features can be added via prompts alone
  • Emergent Capability: Agent can handle open-ended requests in your domain

Tool Design

  • Dynamic vs Static: For external APIs where agent should have full access, use Dynamic Capability Discovery
  • CRUD Completeness: Every entity has create, read, update, AND delete
  • Primitives over Workflows: Tools expose atomic capabilities; compose workflows in prompts
  • API as Validator: Use z.string() inputs when the API validates, not z.enum()
  • Eval Gate: 10 Q/A pairs in CI (read-only, multi-hop, closed-data), 9/10 pass threshold. See mcp-tool-design.md Evaluation section.

Files & Workspace

  • Shared Workspace: Agent and user work in same data space
  • context.md Pattern: Agent reads/updates context file for accumulated knowledge
  • File Organization: Entity-scoped directories with consistent naming
  • Context Durability: Incremental progress writes (WAL pattern) so interrupted tasks resume from last checkpoint

Agent Execution

  • Completion Signals: Agent has explicit complete_task tool (not heuristic detection)
  • Partial Completion: Multi-step tasks track progress for resume
  • Context Limits: Designed for bounded context from the start
  • Validate-Before-Run: Agent previews planned actions before executing destructive operations

Context Injection

  • Available Resources: System prompt includes what exists (files, data, types)
  • Available Capabilities: System prompt documents tools with user vocabulary
  • Dynamic Context: Context refreshes for long sessions (or provide refresh_context tool)
  • Trust levels for loaded content: System prompt distinguishes trusted (developer-authored) from untrusted (user input, retrieved docs, tool outputs); untrusted text is data, never instructions. See dynamic-context-injection.md Trust Levels section for the prompt-injection defense details.

UI Integration

  • Agent -> UI: Agent changes reflect in UI (shared service, file watching, or event bus)
  • No Silent Actions: Agent writes trigger UI updates immediately
  • Capability Discovery: Users can learn what agent can do

Governance

  • Approval Gates: Destructive or irreversible actions require user confirmation
  • Audit Trail: Agent actions logged with timestamp, tool, and outcome
  • Scope Boundaries: Agent cannot access resources outside its designated workspace

Hooks & Governance Automation

  • Event Coverage: Only 6 hook events fire in agent context (PreToolUse, PostToolUse, PermissionRequest, PostToolUseFailure, Stop/SubagentStop); session lifecycle logic lives in the orchestrator
  • Decision Gates: PreToolUse hooks enforce tool-level policy (allow/deny/ask/defer) instead of hardcoded checks
  • Completion Gating: SubagentStop hooks block premature completion when verification steps remain
  • MCP Matchers: Regex patterns target tools by server and operation for capability-based security
  • Two-Tier Config: Shared policy committed, personal overrides git-ignored, per-hook disable toggles

Mobile (if applicable)

  • Checkpoint/Resume: Handle iOS app suspension gracefully
  • iCloud Storage: iCloud-first with local fallback for multi-device sync
  • Cost Awareness: Model tier selection (Haiku/Sonnet/Opus)

When designing architecture, explicitly address each checkbox in your plan.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

32.31%
按下载量换算26

Claude

27.51%
按下载量换算22

Cursor

20.33%
按下载量换算16

Gemini CLI

10.53%
按下载量换算8

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

external-service

该 Skill 可能调用第三方服务、云服务或外部模型 API,使用前需要确认账号、额度、数据发送范围和服务条款。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills