Estack Skill 技能

Estack - Elixir/Phoenix 全栈 AI 编码智能体技能包

技能简介

Estack 是面向 AI 编程智能体（Claude Code / OpenAI Codex / Cursor）的 Elixir 与 Phoenix 全栈技能包，由 ClawBank 工程团队在 9 个月真实生产经验中沉淀而成。该项目以「生产级 Phoenix 应用构建的边界、安全、可观测性」为核心目标，提供 20 个聚焦技能、可选的可信度助手 doctor.py、可丢弃结果检测的 Credo check，以及完整的工作流编排。无论 AI 智能体是要理解陌生代码库、规划新功能、调试故障，还是为 PR 做最后审查，Estack 都给出可重复、有据可查的操作路径。

核心能力

1. estack-architecture：在已有 Phoenix 项目中设计 contexts、Ash actions 与 application interface，确保架构边界清晰。
2. estack-feature：跨 domain、data、UI/API、tests 四层实现一个完整功能，避免漏层或漏测试。
3. estack-debug：基于症状与代码证据定位 Elixir/Phoenix 故障根因，并给出修复方案。
4. estack-review：对 Phoenix diff 做正确性、安全、并发、回归四维度审查，输出可执行结论。
5. estack-pr：为 Elixir/Phoenix 变更准备 PR 与发布包，附准确的验证证据。
6. estack-deploy：准备 Phoenix release、迁移、健康检查、可观察的滚动升级。
7. estack-eval：使用配对任务与盲测评审对比技能版本，给出可重现的评测结果。
8. estack-ecto：实现 Ecto 数据访问、所有权、changeset、事务与安全迁移。
9. estack-liveview：构建 Phoenix LiveView 表单、流、组件、hooks 与鉴权页面。
10. estack-oban：设计稳定的 Oban workers、重试、唯一性与 webhook 处理。
11. estack-security：保护 Phoenix 认证、授权、上传、webhook 与输入边界。
12. estack-doctor：只读检查 Elixir/Phoenix 项目结构，不修改代码，输出文本或 JSON 报告。

安装配置

# Skills CLI 一键安装（Cursor）
npx skills@1.7.2 add singularityhacker/Estack --skill '*' --agent cursor

# 切换到 Claude Code
npx skills@1.7.2 add singularityhacker/Estack --skill '*' --agent claude-code

# 切换到 Codex
npx skills@1.7.2 add singularityhacker/Estack --skill '*' --agent codex

• 需要 Node.js 22.20.0+ 与 npm（用于 Skills CLI），技能本身无应用运行时依赖。
• 可选的 doctor 脚本需要 Python 3.10+，仅做静态检查、不联网、不读 .env。
• 同时支持 Claude Code 插件市场、Cursor 原生安装与手动复制三种方式，详见 docs/installation.md。

使用步骤

1. 先用 doctor 巡检：运行 Use estack-doctor to inspect this project. Give me the three most useful improvements, with evidence, without changing files.，让智能体读懂项目但不修改文件。
2. 按目标选 workflow：理解陌生应用 → estack-doctor；采纳规范 → estack-setup；新功能 → estack-feature；故障定位 → estack-debug；变更审查 → estack-review；准备 PR → estack-pr。
3. 调用具体技能：在 Cursor 中输入 /estack-feature；在 Claude Code 中输入 /estack-feature；在 Codex 中输入 $estack-feature；插件安装则用 /estack:estack-feature。
4. 用 estack-pr 收尾：让智能体基于运行过的命令生成 PR 摘要、附上 .quality/baseline.json 等证据。
5. 回归验证：对关键修复或新功能跑 estack-eval 做配对任务盲测，确认改动没有引入回归。

适用场景

1. 新接手 Phoenix 项目：用 estack-doctor 在 5 分钟内拿到一份基于代码而非想象的巡检报告。
2. 在已有 Phoenix 项目里加入新功能：用 estack-feature 把 domain/data/UI/tests 一次串起来。
3. 线上故障复盘：用 estack-debug 复现 + 修复 + 回归。
4. Code Review 自动化：用 estack-review 在 PR 阶段先做一轮机器审查，节省资深工程师时间。
5. Phoenix 发布前预演：用 estack-deploy 检查 release 配置、迁移顺序、健康端点。
6. 评估自家技能质量：用 estack-eval 配对任务盲测版本对比。

适用人群

• 用 Claude Code / Codex / Cursor 构建 Elixir/Phoenix 应用的工程师与团队
• 希望把 Phoenix 项目的代码生成标准化、可审计的 Tech Lead
• 维护大型 Elixir 系统、需要 CI 中跑通质量门禁的 SRE
• 想要给 AI 智能体一份「权威工作流」取代随机 prompt 的独立开发者

工作原理

Estack 通过 SKILL.md 文件让智能体在每个任务下加载最匹配的子技能（如 estack-feature 自动串联 ecto + liveview + testing）。所有技能均遵循「读上下文 → 用约束生成 → 用 exit gate 验证」的三段式：先读 AGENTS.md 与项目指令，再依据 Phoenix/Elixir 上游文档与已验证实践生成代码，最后通过 Credo、ExUnit、ExCoveralls 或可选的 doctor.py 输出 .quality/*.json 证据。任何 P0 失败都会让 PR 被强制标记为 NOT READY，避免智能体用形容词替代证据。

官方链接

• 仓库：https://github.com/singularityhacker/Estack
• 起源项目 ClawBank：https://clawbank.co
• 配套规范 UsageRules：https://github.com/ash-project/usage_rules
• Tidewave 开发运行时：https://github.com/tidewave-ai/tidewave_phoenix