一、任务背景与核心概念

1.1 什么是 Agent Skill？

Agent Skill 是 Anthropic 为 Claude Code 引入的一种模块化能力扩展机制。与传统的 MCP（Model Context Protocol）不同，Skill 将特定领域的经验封装成可发现、可复用的能力单元，每个技能以文件夹形式存在，包含 SKILL.md 指令文件、脚本代码和资源文件。

Skill 的核心设计理念是渐进式披露（Progressive Disclosure），信息分为三个层次，按需加载：

层级	内容	加载时机
第一层	YAML 元数据（name + description）	智能体启动时预加载
第二层	SKILL.md 完整内容	判断技能相关时加载
第三层	scripts/、references/、assets/	需要执行具体操作时加载

这种设计确保了技能可以包含海量信息却不会撑爆上下文窗口。

1.2 Skill 的标准目录结构

根据工程化实践，一个完整的 Skill 目录结构如下：

skill-name/
├── SKILL.md          # 主入口、触发规则、执行流程
├── references/       # 知识文档、业务口径、案例
├── assets/           # 模板、输出格式规范
├── scripts/          # 可执行脚本（确定性任务下沉）
└── hooks/            # 权限校验、日志埋点

二、Git 仓库解读（一）：gstack

2.1 仓库基本信息

属性	内容
作者	Garry Tan（Y Combinator 总裁）
开源协议	MIT License
最新星数	约 28,000 stars（一周内增长 27,979）
核心定位	将 Claude Code 转变为角色化开发团队

2.2 核心设计理念

gstack 的核心思想是 “Roles, Not Prompts”——与其每次用不同层级的上下文提示 Claude，不如给它分配一个明确的角色。每个角色都有自己的优先级和约束，模拟真实工程团队的运作方式。

2.3 技能架构：8 个 Slash Commands

gstack 提供了 8 个自定义斜杠命令（项目内称为 skills），覆盖软件开发生命周期：

命令	角色	职责
/gstack:ceo	CEO/产品负责人	产品愿景、功能优先级、战略决策
/gstack:eng-manager	工程经理	架构决策、代码审查、技术规划
/gstack:engineer	高级工程师	编写生产代码、实现功能、遵循最佳实践
/gstack:release-manager	发布经理	版本管理、变更日志、发布就绪检查
/gstack:qa	QA 工程师	编写测试、发现边界情况、验证行为
/gstack:devops	DevOps 工程师	基础设施、CI/CD、部署配置
/gstack:browse	UI 交互	浏览器自动化、截图验证
/gstack:retro	回顾	复盘总结

2.4 技术实现

gstack 完全基于 Claude Code 的原生自定义斜杠命令功能构建，每个命令就是一个 Markdown 配置文件，放置在 .claude/commands/ 目录下。安装方式：

# 克隆仓库并复制技能文件到项目目录
git clone --depth 1 https://github.com/garrytan/gstack.git
cp gstack/skills/*.md .claude/commands/

gstack 还具备 Conductor 感知能力，支持多个隔离的 Claude Code 会话并行运行，每个会话拥有独立的浏览器实例，避免状态冲突。

2.5 值得借鉴的设计

1. 角色化思维：通过角色定义强制模型进入特定思维模式，输出质量更稳定
2. 生命周期覆盖：从 CEO 到 DevOps，完整覆盖软件开发全流程
3. 无外部依赖：纯 Markdown 配置，零学习成本

三、Git 仓库解读（二）：Everything Claude Code (ECC)

3.1 仓库基本信息

属性	内容
作者	ChrisWiles（社区项目）
开源协议	未明确标注（需查看仓库）
核心定位	为 Claude Code 增加"长期记忆"和结构化工作流

3.2 核心设计理念

ECC 解决的核心问题是：模型足够强，但"壳"不够聪明。默认的 Claude Code 不会跨会话保存编码偏好，不强制"先规划再编码"的流程，不做结构化 Code Review，不记得哪些决策是"好的经验"。

ECC 在模型之上叠加了一层"操作系统级"的编码规范与习惯层。

3.3 三层架构

3.3.1 Skill 层：可复用工作说明书

ECC 的 Skill 存放路径为 .opencode/skills/*.md 或 .agent/skills/*.md，每个 Skill 包含：

• name：技能名称
• description：适用场景（触发路由规则）
• workflow instructions：完整流程指令

与 gstack 不同，ECC 的 Skill 侧重于工作流编排而非角色扮演。例如前端开发 Skill 会规定：先设计数据模型 → 定义状态更新函数 → 写渲染逻辑 → 最后实现 UI。

3.3.2 Hook 层：自动化好习惯

ECC 充分利用事件系统（20+ Hook）：

Hook	作用
session_start	加载上一次会话上下文，冷启动不丢 context
file_edit	文件变更后自动格式化、lint、验证
session_idle	空闲时保存状态、缓存关键决策

3.3.3 持续学习层：从通用到专属

ECC 提供两个关键命令：

• /learn：从当前会话提取"解决问题的模式"，保存为 instinct，带置信度评分
• /evolve：将相关 instinct 聚合成新 Skill，针对代码库定制

团队层面可以导出 instinct 共享，逐步形成团队级 Skill 库，项目用得越久，Skill 越贴近真实约定。

3.4 技术实现亮点

ECC 支持多模型分工策略：

• 规划阶段：用强模型（claude-sonnet-4-6 或 opus）做架构规划
• 实现阶段：用更轻的模型生成代码
• 小修小改：切换到经济型模型

通过统一 OpenAI 兼容接口（如薛定猫 AI），可以无缝切换不同模型。

3.5 值得借鉴的设计

1. 持续学习机制：/learn 和 /evolve 让 Skill 库可以随项目演进
2. Hook 自动化：将"好习惯"从人为自觉变成工具强制
3. 多模型分工：不同阶段使用不同能力的模型，优化成本与质量平衡

四、两仓库对比总结

维度	gstack	Everything Claude Code
核心定位	角色化团队模拟	长期记忆 + 结构化工作流
Skill 粒度	8 个角色级命令	可无限扩展的流程级 Skill
触发方式	用户手动调用斜杠命令	模型自动判断触发 + Hook 自动执行
学习能力	静态配置	/learn + /evolve 持续进化
适用场景	明确分工的开发流程	需要积累团队经验的长期项目
复杂度	低（纯配置）	中（需要 Hook 和脚本支持）