AtomCode 种子文件与 Skills 系统分析

持续分析迭代 #3 — 内置 Skills、Commands、Subagent 模板、子生态系统 2026-06-22

1. `atomcode setup` 安装的种子文件清单

类型	数量	安装路径
Skills	1 (首次安装)	`~/.atomcode/skills/`
种子标记	每个 skill 一个	`.seed-hash`

种子文件存放在：

~/.atomcode/skills/atomcode-automation-recommender/
├── SKILL.md                                     # 主 skill 定义 (13KB)
├── .seed-hash                                   # 种子哈希（防重复安装）
└── references/
    ├── subagent-templates.md                    # 8 种子 agent 模板
    ├── plugins-reference.md                     # 插件系统文档
    ├── hooks-patterns.md                        # 钩子模式文档
    ├── mcp-servers.md                           # MCP 服务器推荐
    └── skills-reference.md                      # Skills 参考文档

2. 内置 Skills（`atomcode setup` 安装）

Skill	最佳场景
rust-best-practices	Idiomatic Rust 开发
vue-best-practices	Vue 3 Composition API
react-native-best-practices	React Native 性能优化
spring-boot-engineer	Spring Boot 3.x 应用
code-review-excellence	代码审查实践
kubernetes	K8s 运维
docker	容器化
api-design-patterns	REST/GraphQL API 设计
sql-optimization-patterns	查询优化
frontend-testing	Vitest + RTL 测试

共 10 个内置 Skills，涵盖 Rust/Vue/React Native/Spring Boot/K8s/Docker/SQL/Frontend 等主要领域。

3. 内置 Commands（`atomcode setup` 安装的斜杠命令）

命令	最佳场景
`/review`	代码审查工作流
`/refactor`	代码重构
`/lint`	Linting 工作流
`/clippy`	Rust clippy 检查
`/cargo-test`	Rust 测试运行器
`/cargo-run`	Rust 构建 & 运行
`/pytest`	Python 测试运行器
`/tsc-check`	TypeScript 类型检查
`/changelog`	变更日志生成
`/fixissue`	Issue 修复工作流

共 10 个内置 Commands，涵盖 Rust/Python/TypeScript 项目。

4. 插件市场 Skills（官方 plugins）

Skill	插件	安装命令
atomcode-workflows	atomcode-workflows	`/plugin marketplace add <url> && /plugin install atomcode-workflows@atomcode`
commit-craft	commit-craft	(同上) `/plugin install commit-craft@atomcode`
git-worktree	git-worktree	(同上) `/plugin install git-worktree@atomcode`

安装来源：atomcode-plugins-official 市场（托管在 atomgit.com）

5. 内置子代理模板（8 种预设）

代理	推荐场景	推荐模型	工具权限
code-reviewer	大型代码库自动审查	sonnet	Read, Grep, Glob, Bash
security-reviewer	安全审计：auth/支付/PII	sonnet	Read, Grep, Glob（只读）
test-writer	低测试覆盖率项目	sonnet	Read, Write, Grep, Glob
api-documenter	REST/GraphQL 项目	sonnet	Read, Write, Grep, Glob
performance-analyzer	性能瓶颈分析	sonnet	Read, Grep, Glob, Bash
ui-reviewer	前端可访问性/UX	sonnet	Read, Grep, Glob
dependency-updater	依赖安全更新	sonnet	Read, Write, Bash, Grep
migration-helper	框架/版本迁移	opus	Read, Write, Grep, Glob, Bash

子代理的放置方式：

.atomcode/
  agents/
    code-reviewer.md
    security-reviewer.md
    test-writer.md

每个代理是一个独立的 Markdown 文件，包含定义好的工具权限和模型选择。

模型选择指南

模型	最佳场景	折衷
haiku	简单重复检查	快、便宜、不够全面
sonnet	大多数审查/分析	平衡（推荐默认）
opus	复杂迁移、架构	全面、较慢、更贵

工具访问级别

级别	工具	使用场景
只读	Read, Grep, Glob	审查、分析
写入	+ Write	代码生成、文档
完全	+ Bash	迁移、测试

6. Skill Frontmatter 控制

---
name: skill-name              # 必填，斜杠命令名
description: ...              # 描述和何时触发
disable-model-invocation: true # 仅用户可调用
user-invocable: false         # 仅 AtomCode 可调用
allowed-tools: Read, Grep, Glob  # 限制工具权限
---

设置	用户可调用	AtomCode 自动	用途
(默认)	✅	✅	通用 skills
`disable-model-invocation: true`	✅	❌	副作用（部署、发送）
`user-invocable: false`	❌	✅	背景知识参考

7. Skills 目录结构模板

.atomcode/skills/
  my-skill/
    SKILL.md           # 主指令（必填）
    template.yaml      # 模板文件
    scripts/
      validate.sh      # 验证脚本
    examples/          # 参考示例

8. 参数模式

模式	含义	示例
`$ARGUMENTS`	所有参数字符串	`/deploy staging` → "staging"
!`command`	动态指令注入	!`git branch --show-current`

9. 综合种子系统架构

~/.atomcode/setup 子系统
    │
    ├── 官方种子（内置于二进制，通过 setup 解压）
    │   ├── skills/         → 10 个预置 skills
    │   ├── commands/       → 10 个预置 commands
    │   ├── hooks/          → 钩子模板（空目录）
    │   └── mcp.json        → MCP 模板（空配置）
    │
    ├── 社区插件市场（从 git 仓库安装）
    │   ├── atomcode-plugins-official → 3 个插件 skills
    │   └── 用户自定义市场
    │
    └── 项目自定义 .atomcode/skills/
        └── 每个 skill = 一个目录 + SKILL.md

10. MCP 服务推荐（来自参考文件）

MCP 服务器	场景
context7	为常用库/SDK 注入最新文档
React/Vue/Angular	前端框架
Express/FastAPI/Django	后端框架
Prisma/Drizzle	ORM
Stripe/Twilio/SendGrid	第三方 API
AWS SDK/Google Cloud	云 SDK
LangChain/OpenAI SDK	AI/ML 库

11. 钩子模式（来自参考文件）

钩子类型	触发事件
Auto-Formatting	`pre_tool_use`
Type Checking	`post_tool_use`
Protection	`pre_tool_use` (block 危险命令)
Test Runner	`post_tool_use`
Notification	`session_end`

综合分析：种子文件系统覆盖了此前 47 个内置 Skills 盲区

此前的 DEEP_ANALYSIS.md 中列出的盲区「47 个内置 Skills 完整列表」已有结果：

实际情况：系统共提供 12 个核心技能来源：

10 个内置 Skills（通过 atomcode setup 安装）
3 个官方插件技能（通过 atomcode plugin 安装）
每个满足 SKILL.md 格式的项目自定义技能

之前的 "47" 数字来自系统提示词中预先注册的技能总数，这些技能包括：

内置 skills（10）
内置 commands（11，含 guide）
框架级功能（undo/retry/thinking 等约 26 个系统级斜杠命令）

这 47 个技能并非独立的 skill 文件，而是系统提示词中嵌入的功能描述列表，其中约 26 个是 AtomCode 框架的固有功能。

本迭代新增覆盖的盲区

#	之前盲区	状态	发现
1	47 个 Skills 完整列表	✅	10 内置 skills + 3 插件 + ~26 系统级功能 = 总计 ~47
2	内置 Commands	✅	10 个命令（review/refactor/lint/clippy/cargo-test/pytest/tsc 等）
3	子代理模板	✅	8 种预设（coder-reviewer/security/test-writer/api-doc/performance/ui/dependency/migration）
4	Skill 结构标准	✅	SKILL.md + templates + scripts + examples
5	插件安装流程	✅	market registry → plugin install
6	钩子模式参考	✅	5 种模式：Auto-Format/Type Check/Protection/Test/Notification
7	MCP 推荐服务	✅	context7 等外部服务连接

本报告由持续分析循环生成 — Iteration #3

逆向命令索引

bash

# 提取种子文件路径
strings atomcode.bin.bak | grep -E "ATOMCODE\.md|AGENTS\.md|CLAUDE\.md" | sort -u
# 输出: ATOMCODE.md AGENTS.md CLAUDE.md

# 提取设置状态结构体
strings atomcode.bin.bak | grep "struct SetupState"
# 输出: struct SetupState with 5 elements

# 提取插件市场
strings atomcode.bin.bak | grep -iE "marketplace|InstalledPlugin|ExternalSource" | sort -u | head -10

AtomCode 种子文件与 Skills 系统分析 ​

1. atomcode setup 安装的种子文件清单 ​

2. 内置 Skills（atomcode setup 安装） ​

3. 内置 Commands（atomcode setup 安装的斜杠命令） ​

4. 插件市场 Skills（官方 plugins） ​

5. 内置子代理模板（8 种预设） ​

模型选择指南 ​

工具访问级别 ​

6. Skill Frontmatter 控制 ​

7. Skills 目录结构模板 ​

8. 参数模式 ​

9. 综合种子系统架构 ​

10. MCP 服务推荐（来自参考文件） ​

11. 钩子模式（来自参考文件） ​

综合分析：种子文件系统覆盖了此前 47 个内置 Skills 盲区 ​

本迭代新增覆盖的盲区 ​

逆向命令索引 ​