非原生宿主框架的手动适配指南¶

当宿主框架不会原生加载 .claude/、.codex/、.opencode/、.cursor/ 或 .agent/ 布局时，使用本指南。

这是 Grok 等工具以及其他聊天式界面的回退路径：它们可以接受系统提示、上传文件或粘贴的指令，但无法直接执行仓库的原生安装入口。

何时使用本指南¶

当目标宿主框架满足以下情况时，使用手动适配：

• 不会自动加载仓库文件夹
• 不支持自定义斜杠命令
• 不支持钩子
• 不支持仓库本地技能激活
• 具有部分或没有文件系统/工具访问权限

只要存在一等 ECC 目标，就优先使用它：

• Claude Code
• Codex
• Cursor
• OpenCode
• CodeBuddy
• Antigravity

仅当你需要在非原生宿主框架中获得 ECC 行为时，才使用本指南。

你正在复现什么¶

当你手动适配 ECC 时，你试图保留四件事：

1. 聚焦上下文，而不是倾倒整个仓库。
2. 技能激活提示，而不是指望模型猜出工作流。
3. 命令意图，即使宿主框架没有斜杠命令系统。
4. 钩子纪律，即使宿主框架没有原生自动化。

你并不是试图镜像仓库中的每个文件。你试图用尽可能小的上下文包重建有用的行为。

ECC 原生回退方案¶

默认从仓库本身进行手动选择。

只从你实际需要的文件开始：

• 一个语言或框架技能
• 一个工作流技能
• 如果任务专业化，则一个领域技能
• 仅当宿主框架从显式编排中受益时，才使用一个智能体或命令

良好的最小示例：

• Python 功能开发：
• skills/python-patterns/SKILL.md
• skills/tdd-workflow/SKILL.md
• skills/verification-loop/SKILL.md
• TypeScript API 开发：
• skills/backend-patterns/SKILL.md
• skills/security-review/SKILL.md
• skills/tdd-workflow/SKILL.md
• 内容/外发工作：
• skills/brand-voice/SKILL.md
• skills/content-engine/SKILL.md
• skills/crosspost/SKILL.md

如果宿主框架支持文件上传，只上传这些文件。

如果宿主框架只支持粘贴上下文，请提取相关章节并粘贴一个压缩后的包，而不是原始完整文件。

手动上下文打包¶

你不需要额外工具来完成这件事。

直接使用仓库：

cd /path/to/everything-claude-code

sed -n '1,220p' skills/tdd-workflow/SKILL.md > /tmp/ecc-context.md
printf '\n\n---\n\n' >> /tmp/ecc-context.md
sed -n '1,220p' skills/backend-patterns/SKILL.md >> /tmp/ecc-context.md
printf '\n\n---\n\n' >> /tmp/ecc-context.md
sed -n '1,220p' skills/security-review/SKILL.md >> /tmp/ecc-context.md

你也可以在打包前使用 rg 来识别正确的技能：

rg -n "When to use|Use when|Trigger" skills -g 'SKILL.md'

可选：如果你已经使用像 repomix 这样的仓库打包器，它可以帮助将选定文件压缩成一个交接文档。它是一个便捷工具，而不是规范的 ECC 路径。

压缩规则¶

当为另一个宿主框架手动打包 ECC 时：

• 保留任务框架
• 保留激活条件
• 保留工作流步骤
• 保留关键示例
• 先删除重复性文字
• 再删除无关变体
• 当一两个技能足够时，避免粘贴整个目录

如果你需要更紧凑的提示格式，请将必要部分转换为紧凑的结构化块：

<skill name="tdd-workflow">
  <when>New feature, bug fix, or refactor that should be test-first.</when>
  <steps>
    <step>Write a failing test.</step>
    <step>Make it pass with the smallest change.</step>
    <step>Refactor and rerun validation.</step>
  </steps>
</skill>

复现命令¶

如果宿主框架没有斜杠命令系统，请在系统提示或会话前言中定义一个小型命令注册表。

示例：

Command registry:
- /plan -> use planner-style reasoning, produce a short execution plan, then act
- /tdd -> follow the tdd-workflow skill
- /review -> switch into code-review mode and enumerate findings first
- /verify -> run a verification loop before claiming completion

你并不是在实现真正的命令。你是在给宿主框架提供显式的调用句柄，使其映射到 ECC 行为。

复现钩子¶

如果宿主框架没有原生钩子，请将钩子意图放入常设指令中。

示例：

Before writing code:
1. Check whether a relevant skill should be activated.
2. Check for security-sensitive changes.
3. Prefer tests before implementation when feasible.

Before finalizing:
1. Re-read the user request.
2. Verify the main changed paths.
3. State what was actually validated and what was not.

这并不能复现真正的自动化，但它捕捉到了 ECC 的操作纪律。

宿主框架能力矩阵¶

实用的 Grok 风格配置¶

1. 选择最小且有用的包。
2. 将选定的 ECC 技能文件打包成一个上传或粘贴块。
3. 添加一个简短的命令注册表。
4. 添加常设“钩子意图”指令。
5. 从一个任务开始，并在扩大规模之前验证宿主框架是否遵循工作流。

示例起始前言：

You are operating with a manually adapted ECC bundle.

Active skills:
- backend-patterns
- tdd-workflow
- security-review

Command registry:
- /plan
- /tdd
- /verify

Before writing code, follow the active skill instructions.
Before finalizing, verify what changed and report any remaining gaps.

局限性¶

手动适配是有用的，但与原生目标相比，它仍然是二等的。

你将失去：

• 自动安装和同步
• 原生钩子执行
• 真正的命令管道
• 运行时可靠的技能发现
• 内置多智能体/worktree 编排

因此规则很简单：

• 使用手动适配将 ECC 行为带入非原生框架
• 当你想要完整系统时，始终使用原生 ECC 目标

相关工作¶

• 问题 #1186
• 讨论 #1077
• Antigravity 指南
• 故障排除