关于 ce-agent-native-architecture
面向设计和改造 AI Agent 应用的技能,按需提供架构指导,并链接到相应参考文档。内容围绕工具与界面能力对等、原子工具和提示词驱动功能等原则。
主要功能
- 01五项 Agent 原生架构原则
- 02按任务选择参考主题
- 03工具设计与能力对等指导
- 04执行、提示词和上下文模式
- 05测试、重构与移动端模式
适用场景
- 01规划新的 Agent 原生系统
- 02审查工具设计和界面能力对等
- 03为现有应用设计提示词和上下文注入
- 04测试或重构 Agent 原生应用
MCP 相关
该技能的参考主题包含 MCP 工具设计,涉及工具、动态能力发现和 CRUD。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill ce-agent-native-architecture安装后在 Claude Code 中输入/ce-agent-native-architecture确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/action-parity-discipline.mdagent-execution-patterns.mdagent-native-testing.mdarchitecture-patterns.mdchecklists.mddynamic-context-injection.mdfiles-universal-interface.mdfrom-primitives-to-domain-tools.mdmcp-tool-design.mdmobile-patterns.mdproduct-implications.mdrefactoring-to-prompt-native.mdself-modification.mdshared-workspace-architecture.mdsystem-prompt-design.md详细介绍
## Agent 原生架构
Agent 原生应用将 Agent 视为一等公民。功能是 Agent 使用工具并在循环中运行所实现的结果,而不是通过代码编写的函数。支撑 Claude Code 的同一套架构,也能为远超编码领域的应用提供动力。
五项核心原则:
- 对等性 — 用户通过 UI 能做的任何事,Agent 都能通过工具实现。
- 粒度 — 工具是原子基元;功能是由提示词定义的结果。要改变行为,就修改文字,而不是代码。
- 可组合性 — 新功能 = 新提示词,而不是新代码。原子工具与对等性使这一点成为可能。
- 涌现能力 — Agent 能完成你未明确设计的事情。开放式请求可以揭示潜在需求。
- 随时间改进 — 应用可以通过累积上下文(例如
context.md文件)和优化提示词不断改进,无需发布代码。
如需深入了解这些原则如何转化为架构模式,请阅读 references/architecture-patterns.md。
- 设计架构 - 从零开始规划一个新的 Agent 原生系统
- 文件与工作区 - 将文件作为通用接口、共享工作区模式
- 工具设计 - 基础工具、动态能力发现、CRUD 完整性
- 领域工具 - 何时添加领域工具,何时继续使用基础工具
- 执行模式 - 完成信号、部分完成、上下文限制
- 系统提示词 - 定义 Agent 行为和判断标准
- 上下文注入 - 将运行时应用状态注入 Agent 提示词
- 操作对等性 - 确保 Agent 能完成用户能做的一切
- 自我修改 - 让 Agent 能够安全地自我演进
- 产品设计 - 渐进式披露、潜在需求、审批模式
- 移动端模式 - iOS 存储、后台执行、检查点/恢复
- 测试 - 测试 Agent 原生应用的能力和对等性
- 重构 - 让现有代码更具 Agent 原生特性
- 评审 / 检查清单 - 架构检查清单、反模式、成功标准
选择一个编号,或描述你的需求。请等待回复后再继续。
| 回复 | 阅读 | |----------|------| | 1、“设计”、“架构”、“规划” | `references/architecture-patterns.md`,然后应用 `references/checklists.md` 中的检查清单 | | 2、“文件”、“工作区”、“文件系统” | `references/files-universal-interface.md` 和 `references/shared-workspace-architecture.md` | | 3、“工具”、“mcp”、“基础”、“crud” | `references/mcp-tool-design.md` | | 4、“领域工具”、“何时添加” | `references/from-primitives-to-domain-tools.md` | | 5、“执行”、“完成”、“循环” | `references/agent-execution-patterns.md` | | 6、“提示词”、“系统提示词”、“行为” | `references/system-prompt-design.md` | | 7、“上下文”、“注入”、“运行时”、“动态” | `references/dynamic-context-injection.md` | | 8、“对等性”、“UI 操作”、“能力映射” | `references/action-parity-discipline.md` | | 9、“自我修改”、“演进”、“git” | `references/self-modification.md` | | 10、“产品”、“渐进式”、“审批”、“潜在需求” | `references/product-implications.md` | | 11、“移动端”、“ios”、“android”、“后台”、“检查点” | `references/mobile-patterns.md` | | 12、“测试”、“测试”、“验证”、“确认” | `references/agent-native-testing.md` | | 13、“重构”、“现有”、“迁移” | `references/refactoring-to-prompt-native.md` | | 14、“评审”、“审计”、“反模式”、“检查清单”、“成功标准” | `references/checklists.md` |阅读参考资料后,将其中的模式应用到用户的具体情境中。
<reference_index>
参考文件
核心模式:
references/architecture-patterns.md— 事件驱动、统一编排器、Agent 到 UI;全面涵盖五项原则references/files-universal-interface.md— 为什么使用文件、组织方式、context.mdreferences/mcp-tool-design.md— 工具设计、动态能力发现、CRUDreferences/from-primitives-to-domain-tools.md— 何时将基础工具升级为领域工具references/agent-execution-patterns.md— 完成信号、部分完成、上下文限制references/system-prompt-design.md— 将功能作为提示词、判断标准
规范:
references/dynamic-context-injection.md— 运行时上下文注入references/action-parity-discipline.md— 能力映射、对等工作流references/shared-workspace-architecture.md— 共享数据空间、UI 集成references/product-implications.md— 渐进式披露、潜在需求、审批references/agent-native-testing.md— 测试结果、对等测试references/checklists.md— 架构检查清单、反模式、成功标准
平台专属:
references/mobile-patterns.md— iOS 存储、检查点与恢复、成本意识references/self-modification.md— 基于 Git 的演进、防护措施references/refactoring-to-prompt-native.md— 迁移现有代码
评论
支持 Markdown