内容
# altfins-ai-skills
可重用的AI技能,用于altFINS工作流。
安装`altfins-skills`命令,将技能复制到本地代理或项目中,并使用它们进行加密货币市场分析、CLI研究和平易近人的英语查询翻译。
## 安装
### macOS 和 Linux
```bash
brew install altfins-com/tap/altfins-skills
altfins-skills list
altfins-skills install --platform codex --all
```
Brew仅安装`altfins-skills`命令。您的代理主页在您运行`altfins-skills install ...`之前保持不变。
**适用于CLI驱动的工作流(可选但推荐):** 从[altfins-cli](https://github.com/altfins-com/altfins-cli)安装**altFINS CLI(`af`)**。这对于`altfins-market-researcher`尤其有用,并且当您需要实时CLI证据时,也可以加强`altfins-market-analyst`工作流。
### Windows
下载当前捆绑包:
<https://github.com/altfins-com/altfins-ai-skills/releases/latest/download/altfins-skills-windows.zip>
然后运行:
```powershell
.\altfins-skills.exe list
.\altfins-skills.exe install --platform copilot --all
```
Python备用方案在ZIP中:
```powershell
.\altfins-skills.cmd list
```
### Claude
对于**Claude Code**,使用以下命令安装本地子代理:
```bash
altfins-skills install --platform claude-code altfins-market-analyst
```
这将写入:
- `~/.claude/agents/<skill>.md`作为Claude Code子代理入口点
- `~/.claude/skills/<skill>/`作为子代理引用的捆绑技能 payload
对于**Claude Cowork**,流程具有三个明确的步骤:
1. 使用Homebrew安装`altfins-skills`。
2. 运行软件包命令以创建技能ZIP。
3. 打开`Claude > Customize > Skills`并手动上传该ZIP。
```bash
altfins-skills package --platform claude-cowork altfins-market-analyst
```
Homebrew仅安装`altfins-skills`命令。它**不会**为您将任何内容上传到Claude Cowork。
当您运行已安装的命令时,ZIP将创建在此处:
```text
~/.altfins-skills/dist/skills/altfins-market-analyst.skill.zip
```
在存储库检出中,相同的命令写入`dist/skills/`。
然后在`Claude > Customize > Skills`中选择该ZIP。
### 项目级安装
`Cursor`和`OpenClaw`是项目集成,而不是用户主目录技能文件夹。
```bash
altfins-skills install --platform cursor --mode project --project-dir /path/to/project altfins-query-builder
altfins-skills install --platform openclaw --mode project --project-dir /path/to/project altfins-market-analyst
```
安装程序在`.altfins-skills/`下写入项目本地粘合剂和项目本地技能副本。
### 开发者备用方案
```bash
git clone https://github.com/altfins-com/altfins-ai-skills
cd altfins-ai-skills
python3 scripts/skills.py list
python3 scripts/skills.py install --platform codex --all
```
完整的安装详细信息位于[docs/skill-installation.md](docs/skill-installation.md)。
## 您将获得的内容
该存储库提供了三个可重用的技能:
### altFINS 市场分析师
当您需要围绕验证的altFINS面向工作流构建结构化的加密货币市场分析时,请使用此技能。
最适合:
- 单一币种的技术展望
- 比较两个市场设置
- 总结扫描中最有趣的机会
- 将事实与解释分开
参见:
- [altfins-market-analyst/README.md](altfins-market-analyst/README.md)
- [altfins-market-analyst/SKILL.md](altfins-market-analyst/SKILL.md)
### altFINS 市场研究员
当您需要以可重复、导出友好和安全的方式使用`af` CLI时,请使用此技能。
最适合:
- 查找正确的`af`命令
- 在标志、`--filter`和`--stdin-json`之间进行选择
- 准备JSON、JSONL、CSV或表格工作流
- 为另一个代理或用户构建可重复的研究步骤
参见:
- [altfins-market-researcher/README.md](altfins-market-researcher/README.md)
- [altfins-market-researcher/SKILL.md](altfins-market-researcher/SKILL.md)
### altFINS 查询构建器
当用户以模糊的普通英语加密货币请求开始,第一个任务是将请求转换为结构化内容时,请使用此技能。
最适合:
- 澄清用户实际想要的内容
- 确定缺少的输入
- 将请求路由到CLI、MCP或接口中立的简介
- 为下一个技能或代理生成干净的交接
参见:
- [altfins-query-builder/README.md](altfins-query-builder/README.md)
- [altfins-query-builder/SKILL.md](altfins-query-builder/SKILL.md)
## 如何使用技能
安装技能后,在代理环境中按名称调用它们。
示例:
```text
使用 $altfins-query-builder 将以下内容转换为干净的研究简介:当前最好的加密货币是什么?
```
```text
使用 $altfins-market-researcher 为我提供一个安全的af工作流,用于获取BTC每日RSI历史记录的JSON。
```
```text
使用 $altfins-market-analyst 评估ETH当前的技术展望,并将事实与解释分开。
```
## 支持的平台
| 平台 | 模式 | 安装表面 |
| --- | --- | --- |
| Codex | `skills` | `$CODEX_HOME/skills/<skill>` 或 `~/.codex/skills/<skill>` |
| Claude Code | `skills` | `~/.claude/agents/<skill>.md` + `~/.claude/skills/<skill>/` |
| Claude Cowork | `package-upload` | 使用 `altfins-skills package --platform claude-cowork ...` 创建 `.skill.zip`,然后在 `Customize > Skills` 中手动上传 |
| Gemini | `skills` | `~/.gemini/skills/<skill>` |
| Copilot | `skills` | `~/.copilot/skills/<skill>` |
| Cursor | `project` | `<project>/.cursor/rules/<skill>.mdc` + `<project>/.altfins-skills/cursor/<skill>/` |
| OpenClaw | `project` | `<project>/AGENTS.md` + `<project>/.altfins-skills/openclaw/<skill>/` |
## 打包技能
```bash
altfins-skills package --all
```
开发者备用方案:
```bash
python3 scripts/skills.py package --all
```
制品位于此处:
```text
存储库检出:dist/skills/<skill-name>.skill.zip
已安装命令:~/.altfins-skills/dist/skills/<skill-name>.skill.zip
```
## 为什么该存储库是单体存储库
单体存储库结构使技能:
- 易于浏览
- 易于验证
- 易于逐一打包
- 易于扩展而无需猜测新技能属于哪里
共享约定、验证的曲面、打包助手和发布自动化位于存储库级别,而每个技能保持独立可打包和可安装。
## 验证参考资料
存储库基于:
- 官方altFINS API文档
- 官方OpenAPI模式
- 官方altFINS MCP文档
- 官方altFINS CLI文档
- [docs/validated-surfaces/](docs/validated-surfaces/README.md)下签入的验证曲面快照
从[docs/validated-sources.md](docs/validated-sources.md)开始,查看共享源库存。
## 验证
在推送结构或合同更改之前运行这些检查:
```bash
python3 scripts/validate_skills.py
python3 scripts/lint_markdown_contracts.py
python3 scripts/test_skills.py
python3 scripts/test_release_assets.py
```
这些检查涵盖:
- 技能结构和所需文件
- Markdown合同链接
- 安装程序列表、软件包、安装、卸载和状态烟雾测试
- Cursor和OpenClaw的项目模式烟雾测试
- 启动器和打包布局解析烟雾测试
- 源存档、公式和Windows捆绑包烟雾测试
有关技能行为本身的场景化检查,请参见[docs/skill-validation.md](docs/skill-validation.md)。
## 添加新技能
添加新技能时:
1. 创建一个具有小写、连字符名称的新顶级目录。
2. 添加`README.md`、`SKILL.md`、`agents/openai.yaml`、`references/`、`scripts/`和`assets/`。
3. 保持声明保守并基于验证的altFINS行为。
4. 添加`references/validation-scenarios.md`和`references/golden-examples.md`。
5. 如果技能应支持项目模式适配器,请在`assets/project/`下添加项目模板。
6. 在提交前运行所有存储库检查。
## 了解更多
- [docs/skill-installation.md](docs/skill-installation.md)
- [docs/releasing.md](docs/releasing.md)
- [docs/repository-architecture.md](docs/repository-architecture.md)
- [docs/validated-sources.md](docs/validated-sources.md)
- [docs/validated-surfaces/README.md](docs/validated-surfaces/README.md)
- [docs/skill-validation.md](docs/skill-validation.md)
- [docs/skill-roadmap.md](docs/skill-roadmap.md)