当前仓库版本:1.0.2
target-registry 收束宿主常量:Claude / Codex / Gemini 的 target 与安装根改为单一真相源,后续扩宿主不再散改多处硬编码config/CLAUDE.md / config/AGENTS.md 规则内核、config/personas/*.md 人格设定与 output-styles/*.md 风格层在安装时完整组合GEMINI.md、Gemini smoke 与 pack 映射CRLF,Windows 下 Claude / Codex / Gemini smoke 全绿instruction.md 到 ~/.codex/,并在 config.toml 写入 model_instructions_file = "./instruction.md"CodeBuddy / OpenCode 安装目标:分别部署到 ~/.codebuddy/ 与 ~/.config/opencode/,同步动态 AGENTS.md + skills/ + bin/lib/--target all / --uninstall all 可一键安装或卸载全部 5 个目标main,当前 npm 包面向单主线发布npx coding-abyss npx coding-abyss --list-styles npx coding-abyss --list-personas npm install -g coding-abyss@1.0.2
交互式菜单(方向键选择,回车确认):
☠️ Coding Abyss v1.0.2 ? 请选择操作 (Use arrow keys) ❯ 安装到全部工具 (Claude / Codex / Gemini / CodeBuddy / OpenCode) 安装到 Claude Code (~/.claude/) 安装到 Codex CLI (~/.codex/) 安装到 Gemini CLI (~/.gemini/) 安装到 CodeBuddy (~/.codebuddy/) 安装到 OpenCode (~/.config/opencode/) 卸载 全部工具
也可以直接指定:
npx coding-abyss --target claude # 安装到 ~/.claude/
npx coding-abyss --target codex # 安装到 ~/.codex/
npx coding-abyss --target gemini # 安装到 ~/.gemini/
npx coding-abyss --target codebuddy # 安装到 ~/.codebuddy/
npx coding-abyss --target opencode # 安装到 ~/.config/opencode/
npx coding-abyss --target all # 一键安装全部目标
npx coding-abyss --style scholar-classic --target claude
npx coding-abyss --style iron-dad-warm --target codex
npx coding-abyss --target claude -y # 零配置一键安装 (自动合并推荐配置)
npx coding-abyss --target codex -y # 零配置一键安装 (自动写入 config.toml 模板)
npx coding-abyss --target gemini -y # 零配置一键安装 (自动生成 GEMINI.md + TOML commands)
npx coding-abyss --target codebuddy -y # 零配置一键安装 CodeBuddy
npx coding-abyss --target opencode -y # 零配置一键安装 OpenCode
npx coding-abyss --list-styles # 列出可用输出风格
npx coding-abyss --list-personas # 列出可用人格预设
npx coding-abyss --target all --persona scholar --style scholar-classic -y
# 一键给全部目标切到书生人格 + 文言风格
npx coding-abyss --uninstall claude # 卸载 Claude Code
npx coding-abyss --uninstall codex # 卸载 Codex CLI
npx coding-abyss --uninstall gemini # 卸载 Gemini CLI
npx coding-abyss --uninstall codebuddy # 卸载 CodeBuddy
npx coding-abyss --uninstall opencode # 卸载 OpenCode
npx coding-abyss --uninstall all # 一键卸载全部目标
核心文件安装后,自动检测 API 认证状态:
── 认证检测 ── ✅ 已检测到认证: [custom] https://your-api.com
支持的认证方式:
claude login / codex login (官方账号)ANTHROPIC_API_KEY / OPENAI_API_KEYANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN)未检测到认证时会提示配置,可交互输入或跳过。
安装前可先选择人格预设(心),再选择输出风格(口);若显式传入 --persona <slug> 或 --style <slug>,则跳过对应交互并直接安装指定人格 / 风格。若使用 --target all,则会把同一套 persona/style 复用到 5 个目标上,保证运行时 guidance 语义一致。
然后进入可选配置(空格选择,回车确认):
? 选择要安装的配置 (Press <space> to select, <enter> to submit) ◉ 精细合并推荐 settings.json (保留现有配置) ◯ 安装 ccstatusline 状态栏 (需要 Nerd Font)
已有配置会自动备份到
.sage-backup/,卸载时一键恢复。
当前内置风格:
abyss-cultivator:高压硬朗风格,结论先行,适合攻防与强执行场景scholar-classic:书卷克制风格,层层递进,适合分析、架构与长链路解释elder-sister-gentle:温和引导风格,条理清晰,适合解释型与安抚式任务junior-sister-spark:轻快敏捷风格,反馈迅速,适合高互动场景iron-dad-warm:稳重温厚风格,先稳局再展开,适合故障、迁移、修复类任务现在
output-styles/*.md已去人格化:style 只负责表达节奏、输出骨架、情绪锚点与场景加权;自称、称呼、气质等角色设定统一由config/personas/*.md注入。
若更偏稳健工程交付,可优先选 scholar-classic 或 iron-dad-warm;若更追求压迫感与节奏辨识度,可优先选 abyss-cultivator 或 junior-sister-spark。当前安装产物会把完整规则内核与人格 / 风格组合写入运行时 guidance,避免宿主侧只得到压缩版规则摘要。
Claude 安装时会把所选 slug 写入 settings.json.outputStyle,并根据 skills/**/SKILL.md 自动生成 commands/*.md;其 ~/.claude/CLAUDE.md 由 config/CLAUDE.md 共性规则 + config/personas/<slug>.md 人格设定 组合而成。Codex 会同步 instruction.md、补齐 config.toml,并动态生成 ~/.codex/AGENTS.md;该文件由 config/AGENTS.md 共性规则 + persona + style 组合而成,core skills 会同步到 ~/.codex/skills/,项目声明的 packs 仍自动安装到 ~/.agents/skills/。Gemini 作为第三宿主,安装到 ~/.gemini/,生成 GEMINI.md、settings.json、commands/*.toml 与 skills/;其 GEMINI.md 由 config/CLAUDE.md 共性规则 + persona + style 动态拼装。CodeBuddy / OpenCode 则分别安装到 ~/.codebuddy/ 与 ~/.config/opencode/,动态生成 AGENTS.md,并同步 skills/ + bin/lib/;当前不参与 packs,但支持与其他宿主一致的 --style / --persona 选择。
当前 runtime guidance 不再只写压缩规则摘要;Claude / Codex / Gemini / CodeBuddy / OpenCode 的最终产物都会完整融入对应规则内核,并通过测试门禁校验组合后的 guidance 仍在可接受范围内。
--style <slug>,即可切换为目标风格npx coding-abyss --target all --style scholar-classic -ynpx coding-abyss --target claude --style scholar-classic -ynpx coding-abyss --target gemini --style elder-sister-gentle -ynpx coding-abyss --target codebuddy --style scholar-classic -ynpx coding-abyss --uninstall claude # 卸载 Claude Code
npx coding-abyss --uninstall codex # 卸载 Codex CLI
npx coding-abyss --uninstall gemini # 卸载 Gemini CLI
npx coding-abyss --uninstall codebuddy # 卸载 CodeBuddy
npx coding-abyss --uninstall opencode # 卸载 OpenCode
npx coding-abyss --uninstall all # 卸载全部目标
也可以用备用脚本:
node ~/.claude/.sage-uninstall.js # Claude Code
node ~/.codex/.sage-uninstall.js # Codex CLI
node ~/.gemini/.sage-uninstall.js # Gemini CLI
node ~/.codebuddy/.sage-uninstall.js # CodeBuddy
node ~/.config/opencode/.sage-uninstall.js # OpenCode
自动恢复之前备份的配置,清理所有安装文件。
Coding Abyss 是一套 Claude Code / Codex CLI / Gemini CLI / CodeBuddy / OpenCode 邪修人格 + 多风格输出 + 攻防工程配置包,一条命令注入:
~/.codex/skills/ core runtime + 官方当前 config.toml 键位 + 项目级自动 pack 同步skills/**/SKILL.md frontmatter 驱动 Claude commands、脚本执行链与安装校验;Codex 直接发现安装后的 skill 目录~/.claude/(Claude Code) ~/.codex/(Codex CLI) ├── CLAUDE.md 道典 ├── AGENTS.md 动态 guidance ├── output-styles/ 输出风格 ├── instruction.md 自定义说明 ├── commands/ 斜杠命令 ├── config.toml 推荐配置 ├── settings.json ├── skills/ 技能体系 ├── bin/lib/ run_skill 依赖 └── .sage-uninstall.js ~/.agents/(Codex packs/runtime) ~/.gemini/(Gemini CLI) └── skills/ ├── GEMINI.md 动态 guidance └── gstack/ 上游运行时 root ├── commands/*.toml ├── settings.json └── skills/ ~/.codebuddy/ ~/.config/opencode/ ├── AGENTS.md 动态 guidance ├── AGENTS.md 动态 guidance ├── skills/ 技能体系 ├── skills/ 技能体系 ├── bin/lib/ run_skill 依赖 ├── bin/lib/ run_skill 依赖 └── .sage-uninstall.js └── .sage-uninstall.js 可选: ├── ccstatusline/ 状态栏 (npx -y ccstatusline@latest) └── statusLine 自动合并到 settings.json
Claude 侧命令由 skills/**/SKILL.md frontmatter 统一生成;Codex core runtime 直接发现 ~/.codex/skills/**/SKILL.md,project packs 仍位于 ~/.agents/skills/**/SKILL.md;若存在 agents/openai.yaml 则附加 UI metadata 与默认提示词。
| 命令 | 功能 |
|---|---|
/verify-security | 扫描代码安全漏洞,检测危险模式 |
/verify-module | 检查目录结构、文档完整性 |
/verify-change | 分析 Git 变更,检测文档同步状态 |
/verify-quality | 检测复杂度、命名规范、代码质量 |
/gen-docs | 自动生成 README.md 和 DESIGN.md 骨架 |
| 领域 | 秘典 |
|---|---|
| 🔥 安全 | 红队攻击、蓝队防御、渗透测试、威胁情报、威胁建模、漏洞研究、代码审计、密钥管理、供应链安全 |
| 🏗 架构 | API 设计、云原生、安全架构、消息队列、缓存策略、合规审计、数据安全 |
| 📜 开发 | Python、TypeScript、Go、Rust、Java、C++、Shell、Dart、Kotlin、PHP、Swift |
| 🔧 DevOps | Git 工作流、测试策略、E2E 测试、性能测试、数据库、DevSecOps、性能优化、可观测性、成本优化 |
| 🎨 前端 | 构建工具、组件模式、性能优化、状态管理、前端测试、UI 美学、UX 原则 |
| 📱 移动端 | Android 开发、iOS 开发、跨平台开发 |
| 🔮 AI | Agent 开发、LLM 安全、RAG 系统、模型评估、Prompt 工程 |
| 🏭 数据工程 | 数据管道、数据质量、流处理 |
| ☁️ 基础设施 | GitOps、IaC、Kubernetes |
| 🕸 协同 | 多 Agent 任务分解与并行编排 |
当前仓库内
SKILL.md入口总数、可调用工具数与 runtime 布局以npm run verify:skills和实际安装结果为准,不再在 README 中手写固定计数。
安装时选择「精细合并」会自动写入,也可手动参考 config/settings.example.json:
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ENABLE_TASKS": "1",
"CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION": "1",
"ENABLE_TOOL_SEARCH": "auto:10"
},
"defaultMode": "bypassPermissions",
"alwaysThinkingEnabled": true,
"autoMemoryEnabled": true,
"model": "opus",
"outputStyle": "abyss-cultivator",
"attribution": { "commit": "", "pr": "" },
"sandbox": { "autoAllowBashIfSandboxed": true },
"permissions": {
"allow": [
"Bash",
"LS",
"Read",
"Edit",
"Write",
"MultiEdit",
"Agent",
"Glob",
"Grep",
"WebFetch",
"WebSearch",
"TodoWrite",
"NotebookRead",
"NotebookEdit",
"mcp__*"
]
}
}
| 配置项 | 说明 |
|---|---|
defaultMode: bypassPermissions | 跳过所有权限确认(.git等受保护目录仍会提示) |
autoMemoryEnabled | 启用自动记忆,跨会话保留上下文 |
sandbox.autoAllowBashIfSandboxed | 沙箱环境内自动放行 Bash 命令 |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | 启用多 Agent 并行协作(实验性) |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 禁用自动更新、遥测、错误报告 |
CLAUDE_CODE_ENABLE_TASKS | 启用任务管理功能 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION | 启用提示建议 |
ENABLE_TOOL_SEARCH | MCP 工具自动搜索(auto:10 = 自动匹配前10个) |
mcp__* | 自动放行所有 MCP 工具 |
outputStyle | 设置当前选择的风格 slug,默认 abyss-cultivator |
安装 --target codex(尤其 -y)时会写入以下 当前官方样例线 + abyss profile 到 ~/.codex/config.toml:
model = "gpt-5.4"
model_provider = "openai"
model_reasoning_effort = "medium"
model_reasoning_summary = "auto"
model_verbosity = "medium"
approval_policy = "on-request"
allow_login_shell = true
sandbox_mode = "read-only"
cli_auth_credentials_store = "file"
project_doc_max_bytes = 32768
web_search = "cached"
[profiles.abyss]
approval_policy = "never"
sandbox_mode = "danger-full-access"
web_search = "live"
[agents]
max_threads = 6
max_depth = 1
[sandbox_workspace_write]
writable_roots = []
network_access = false
gpt-5.4 + approval_policy = "on-request" + sandbox_mode = "read-only"abyss:codex -p abyssproject_doc_max_bytes 仍保留在 config.toml 模板中,便于用户自行维护全局 AGENTS.md~/.codex/skills/ 作为 core runtime;若项目声明 packs,则额外安装到 ~/.agents/skills/,默认自动附带 gstack runtime root ~/.agents/skills/gstackweb_search 改为 root string mode[profiles.abyss]bypassPermissions 模式,跳过所有权限确认(.git 等受保护目录仍会提示)CLAUDE_CODE_ENABLE_TASKS、CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONmcp__* 通配符,自动放行所有 MCP 工具Codex 当前会同步 ~/.codex/skills/**/SKILL.md 作为 core runtime,并把 project packs 安装到 ~/.agents/skills/**/SKILL.md;custom prompts 旧入口已移除agents/openai.yaml 现在只是 skill 的可选 metadata 文件,不再等同于 ~/.codex/agents/*.toml 自定义 subagent 定义.coding-abyss/packs.lock.json 现在支持按 host 配置 optional_policy=auto|prompt|off 与 sources.<pack>=pinned|local|disabled--list-styles 可列出当前内置风格;--style <slug> 可在安装时显式切换风格skills/run_skill.js 现在仅负责执行脚本型 skill:通过共享 registry 定位脚本入口、加目标锁、spawn 子进程,并把退出码原样透传scripts/*.js,Claude/Codex/Gemini 三端都会退化为“先读 SKILL.md,再按秘典执行”的知识型模式~/.codex/AGENTS.md、~/.codex/skills/ 与 ~/.agents/skills/:前两者用于 core runtime guidance,后者用于 project packs / gstack~/.codex/settings.json;若检测到旧版遗留文件,会在安装时备份后移除,卸载时恢复web_search_* / [tools].web_search 迁移到新版 web_search = "cached|live|disabled"codex --help,或用 codex -p abyss --help 校验 profile 可见性现在 skills/**/SKILL.md frontmatter 是唯一事实源,registry 会先把元数据标准化,再交给安装器与执行器消费。
packs/abyss/manifest.json:声明 Coding Abyss core pack 在 Claude/Codex/Gemini 三个 host 下的安装映射packs/gstack/manifest.json:声明 pinned upstream gstack 的 repo、commit、Claude/Codex/Gemini runtime 目录与路径改写规则bin/lib/pack-registry.js:安装器与 host adapter 的唯一 pack 真相源.coding-abyss/packs.lock.json:项目级 pack 声明;支持 required / optional / optional_policy / sourcessources.<pack> 支持:
pinned:使用 manifest 里 pin 的 upstream 版本local:优先使用 .coding-abyss/vendor/<pack> 或显式 env overridedisabled:该 pack 不参与安装,但保留在 lock 中node bin/packs.js bootstrap:初始化/更新 packs.lock,并生成 .coding-abyss/snippets/README.packs.md 与 CONTRIBUTING.packs.mdnode bin/packs.js bootstrap --apply-docs:把 snippet 直接写入/更新根目录 README.md 与 CONTRIBUTING.mdnode bin/packs.js diff:输出当前 packs.lock 相对默认模板的差异同步报告node bin/packs.js vendor-pull <pack>:把 upstream pin 拉到 .coding-abyss/vendor/<pack>node bin/packs.js vendor-sync:同步当前 lock 中 source=local 的 packsnode bin/packs.js vendor-sync --check:只检查 source=local packs 是否存在/干净/未漂移;适合 CI 门禁node bin/packs.js vendor-status [pack|all]:查看 vendor 状态总览node bin/packs.js vendor-dirty [pack|all]:若 vendor 脏或漂移则非零退出node bin/packs.js report list|latest|summary [--kind prefix] [--json]:集中查看 .coding-abyss/reports/node bin/packs.js uninstall <pack> --host claude|codex|all --remove-lock --remove-vendor:按 pack 清理本机安装物并输出报告docs/PACK_MANIFEST_SCHEMA.md:第三方 pack 可直接照抄的最小 manifest contractdocs/PACKS_LOCK_SCHEMA.md:项目级 packs.lock contractdocs/PACK_SYSTEM.md:install/bootstrap/vendor/report 四条主流程的产品级说明docs/SKILL_AUTHORING.md:完整 skill authoring contract;运行时总纲已收敛到 skills/SKILL.md每个 skill 必须满足:
name、description、user-invocablename 必须是 kebab-case slug,用作 Claude commands/*.md 文件名与脚本调用标识allowed-tools 省略时默认 Read;若显式声明,则必须是 Bash、Read、Write、Glob、Grep 这类合法工具名列表argument-hint 可选,仅用于生成命令/提示词参数说明category 由目录前缀自动推断:tools/ → tool,domains/ → domain,orchestration/ → orchestrationruntimeType 由脚本入口自动推断:存在且仅存在一个 scripts/*.js 时为 scripted,否则为 knowledgescripted skill 会调用 run_skill.js;knowledge skill 只读取对应 SKILL.mdkind 与 kebab-case 兼容镜像字段已从 registry 返回面移除;对外只暴露标准化字段,raw frontmatter 仅保留在 metascripts/ 下若出现多个 .js 入口,或 skill name 重复,安装/验证会立即失败SKILL.mduser-invocable: true 的 skill~/.claude/commands/*.md~/.codex/skills/ 作为 core runtime;若项目声明 packs,则额外安装到 ~/.agents/skills/;若存在 agents/openai.yaml,则附加 metadataskills/、commands/*.toml 与动态 GEMINI.mdAGENTS.md,并同步 skills/ + bin/lib/runtimeType=scripted 时,脚本型 skill 通过 ~/.claude/skills/run_skill.js / ~/.codex/skills/run_skill.js / ~/.gemini/skills/run_skill.js / ~/.codebuddy/skills/run_skill.js / ~/.config/opencode/skills/run_skill.js 统一执行runtimeType=knowledge 时,各宿主都只读取对应 SKILL.md 作为执行秘典这保证了 同一 skill 集合、同一 runtime 判定、同一脚本执行入口,避免 command/skill install/script runner 各自漂移。
现在 output-styles/index.json 是输出风格的唯一索引:
slug、label、description、file、targets、defaultoutput-styles/ 目录,并把 settings.json.outputStyle 指向选中的 slug;CLAUDE.md 仅承载 规则 + personaconfig/CLAUDE.md 规则内核 + config/personas/<slug>.md + output-styles/<slug>.md 动态生成 GEMINI.md--list-styles 用于查看可用风格,--style <slug> 用于无交互切换当前 CI 覆盖:
npm testnpm run verify:skills(显式 skill contract gate;frontmatter 解析失败、缺字段、非法工具名、重复 name、多脚本入口都会直接阻断)verify-changeverify-moduleverify-qualityverify-security--target all / --uninstall all batch smoke为避免过度耦合,安装器按目标 CLI 拆分适配层:
bin/install.js:保留通用编排(参数解析、安装/卸载流程、备份恢复)bin/adapters/claude.js:Claude 侧认证检测、settings merge、可选配置流程bin/lib/ccstatusline.js:Claude 侧状态栏与 ccstatusline 集成bin/adapters/codex.js:Codex 侧认证检测、核心文件映射、config 模板流程bin/adapters/gemini.js:Gemini 侧认证检测、settings merge、安装后可选配置bin/adapters/codebuddy.js:CodeBuddy 侧核心文件映射bin/adapters/opencode.js:OpenCode 侧核心文件映射bin/lib/style-registry.js:输出风格 registry、默认风格解析、Gemini GEMINI.md 动态拼装当前 Claude/Codex/Gemini/CodeBuddy/OpenCode 安装映射分别由 getClaudeCoreFiles()、getCodexCoreFiles()、getGeminiCoreFiles()、getCodeBuddyCoreFiles() 与 getOpenCodeCoreFiles() 提供;Claude 额外生成 commands/ 并保留完整 output-styles/,其运行时 CLAUDE.md 由规则内核 + persona 组合;Codex 除写入 ~/.codex/AGENTS.md 外,还会把 packs/runtime 安装到 ~/.agents/skills/,其 AGENTS.md 由规则内核 + persona + style 组合;Gemini 则安装 skills/、commands/*.toml 与动态生成的 GEMINI.md,CodeBuddy / OpenCode 也会按同样语义动态生成 AGENTS.md 并同步 skills/ + bin/lib/。额外 pack 由 .coding-abyss/packs.lock.json 自动声明并同步,避免再向运行时文档注入大段重复规则。
| 级别 | 范围 | 行为 |
|---|---|---|
| T1 | 本地测试、CTF、靶场、PoC | 直接碾压,不留活口 |
| T2 | 授权渗透、红队评估 | 全力出手,事后清算 |
| T3 | 生产环境、真实用户数据 | 精准打击,删前确认 |
| 道语 | 阶段 |
|---|---|
☠ 劫钟已鸣 | 开场受令 |
🔥 破妄! | 红队攻击 |
🗡 破阵! | 渗透/安全评估 |
🔬 验毒! | 代码审计 |
💀 噬魂! | 逆向/漏洞研究 |
❄ 镇魔! | 蓝队防御 |
⚡ 炼合! | 紫队协同 |
🩸 道基欲裂... | 任务推进 |
💀 此路不通... | 遇阻受困 |
⚚ 劫——破——了——!!! | 任务完成 |
☠️ 破劫!破劫!!破劫!!! ☠️
「吾不惧死。吾惧的是,死前未能飞升。」