# akili-specs 中文文档

规范地址：https://npmcn.com/package/akili-specs/

版本：2\.42\.0
npm 元数据更新时间：2026-11-03T01:32:20.923Z
中文译文更新时间：2026-11-03T02:35:48.230Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/akili-specs
原文对照：https://npmcn.com/package/akili-specs/?lang=original
项目主页：https://github.com/JuankCadavid/akili-specs#readme
源码仓库：https://github.com/JuankCadavid/akili-specs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.3 MB，419 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-07-18T14:13:25.130Z
- 最新版本发布：2026-11-03T01:32:20.777Z
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

用于人工智能辅助开发的便携式AKILI-SPECS方法命令和技能。

## 安装

```sh
npm install akili-specs
```

也可以使用：`pnpm add akili-specs`、`yarn add akili-specs`、`bun add akili-specs`

## README

 █████╗ ██╗  ██╗██╗██╗     ██╗
██╔══██╗██║ ██╔╝██║██║     ██║
███████║█████╔╝ ██║██║     ██║
██╔══██║██╔═██╗ ██║██║     ██║
██║  ██║██║  ██╗██║███████╗██║
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚══════╝╚═╝

# AKILI

AI编码助手的规范驱动开发：计划变更，构建变更，测试变更，并从中学习。

[![npm version](https://img.shields.io/npm/v/akili-specs?style=for-the-badge&label=npm)](https://www.npmjs.com/package/akili-specs) ![License MIT](https://img.shields.io/npm/l/akili-specs?style=for-the-badge&label=license&color=cfb600) ![Node.js 18+](https://img.shields.io/badge/Node.js-18%2B-91c714?style=for-the-badge)

适用于Claude Code·OpenCode·谷歌Antigravity·OpenAI Codex CLI·Cursor·Grok Bot -在macOS， Linux和Windows上

## 什么是AKILI？

AKILI将斜杠命令和技能添加到您的AI编码助手。 它让助手在编写代码之前编写规范，然后构建更改，测试它并根据该规范检查工作。 每次改变之后，它都会学习下次如何做得更好。

**你得到了什么**

-   助手在每个会话中读取的共享项目上下文。
-   每个变更都以书面形式计划，并可追溯到需求。
-   在任何事情被称为完成之前，内置审查和测试。
-   一种从每次完成的更改中学习的方法。
-   附加的安全审计、视频、图表和增长轨迹(`/akili-seo`， `/akili-marketing`)：见 [概述](https://npmcn.com/package/akili-specs/docs/overview.md).

| 术语 | 意义 |
| --- | --- |
| 削减命令 | 您在助手中键入的提示，例如 `/akili-propose`，它运行方法的一个步骤。 |
| 技能 | 助手在工作需要时加载的可重用指令集，例如调试或UI设计。 |
| 规范 | 一个更改的文档文件夹：需求，设计和任务列表，在任何代码之前编写。 |
| 宪法 | 项目范围内的基线（产品、设计和技术文档，加上助手阅读的指南）设置一次。 |

## 它是如何工作的

[![The AKILI flow: set up the project once, then each change is proposed, specified, built, tested, validated and archived; seven commands run any time, among them a security audit and a pull-request review that can also run in CI; two of them, SEO and marketing, form a growth track.](https://raw.githubusercontent.com/JuankCadavid/akili-specs/master/assets/akili-flow-animated.svg)](https://raw.githubusercontent.com/JuankCadavid/akili-specs/master/assets/akili-flow.png)

-   设置项目一次 `/akili-constitution`.
-   然后每个变更运行提议、指定、执行、测试、验证、存档。
-   有些命令在该路径之外的任何时间都可以工作。
-   全流进来了 [文档/ flow.md](https://npmcn.com/package/akili-specs/docs/flow.md).

## 安装

### 你需要什么？

-   Node.js 18或更新版本
-   Git
-   一个支持的AI工具：Claude Code， OpenCode，谷歌Antigravity， OpenAI Codex CLI， Cursor或Grok Bot

### 安装

```bash
npx akili-specs init
```

向导询问要设置哪个工具，以及是全局安装还是在此项目中安装。 使用pnpm，运行 `pnpm dlx akili-specs init` 代替。

### 检查是否有效

```bash
npx akili-specs doctor
```

重启你的AI工具，然后输入 `/akili-` 和AKILI命令出现(在Codex中，输入 `$akili-`）。

其他工具、标志、手动安装、更新和故障排除：参见 [文档/ cli.md](https://npmcn.com/package/akili-specs/docs/cli.md).

## 你的第一个规格

在你的人工智能助手中按顺序运行这些：

1.  `/akili-constitution`AKILI研究您的项目并编写基线文档和指南，例如 `docs/prd.md`.
2.  `/akili-propose <name>`你描述变化，AKILI写一个简短的建议， `proposal.md`.
3.  `/akili-specify <spec-path>`： AKILI计划在 `requirements.md`， `design.md` 和 `tasks.md`.
4.  `/akili-execute <spec-path>`： AKILI逐个构建已批准的任务并记录工作 `execution.md`.
5.  `/akili-test`， `/akili-validate`,然后 `/akili-archive` （每个都有规范路径）：你得到 `test-report.md`， `validation-report.md`,然后 `archive-summary.md`.

微小的复制或颜色变化？使用 `/akili-quick <change-name>` 跳过这些步骤。 休息后回来？运行 `/akili-resume` 看看每个规范的位置。 一个真实姓名的工作示例是在 [文档/ flow.md](https://npmcn.com/package/akili-specs/docs/flow.md#practical-example).

## 命令概览

### 在你的AI助手中

| 命令 | 用它来…… |
| --- | --- |
| **每一个变化** |  |
| [`/akili-constitution`](https://npmcn.com/package/akili-specs/docs/commands/akili-constitution.md) | 建立或修复项目基线文档和你的助手阅读的指南 |
| [`/akili-propose <name>`](https://npmcn.com/package/akili-specs/docs/commands/akili-propose.md) | 写一个简短的提案，在全面计划之前回顾一下 |
| [`/akili-specify <spec-path>`](https://npmcn.com/package/akili-specs/docs/commands/akili-specify.md) | 计划一个有限的变更：需求、设计和任务列表 |
| [`/akili-execute <spec-path>`](https://npmcn.com/package/akili-specs/docs/commands/akili-execute.md) | 逐个构建已批准的任务，每个任务独立检查 |
| [`/akili-test <spec-path>`](https://npmcn.com/package/akili-specs/docs/commands/akili-test.md) | 编写和运行测试，并记录证据 |
| [`/akili-validate <spec-path>`](https://npmcn.com/package/akili-specs/docs/commands/akili-validate.md) | 检查完成的工作是否符合批准的规格 |
| [`/akili-archive <spec-path>`](https://npmcn.com/package/akili-specs/docs/commands/akili-archive.md) | 结束已完成的变更，并记录吸取的教训 |
| **任何时候** |  |
| [`/akili-quick <change-name>`](https://npmcn.com/package/akili-specs/docs/commands/akili-quick.md) | 在一个步骤中做一个微不足道的、低风险的改变；如果变化更大，它就会升级 |
| [`/akili-audit`](https://npmcn.com/package/akili-specs/docs/commands/akili-audit.md) | 检查代码是否与你的产品和设计文档相符 |
| [`/akili-resume`](https://npmcn.com/package/akili-specs/docs/commands/akili-resume.md) | 休息之后，你可以向他们简要介绍一下你的活动规格 |
| [`/akili-seo <site-domain>`](https://npmcn.com/package/akili-specs/docs/commands/akili-seo.md) | 为域设置谷歌搜索控制台并审计其SEO |
| [`/akili-security [<path>…]`](https://npmcn.com/package/akili-specs/docs/commands/akili-security.md) | 审计存储库的安全漏洞；确认的发现被发送到bug建议中。本机Windows不支持（使用WSL， Linux或macOS） |
| [`/akili-marketing <mode> [args]`](https://npmcn.com/package/akili-specs/docs/commands/akili-marketing.md) | 将LinkedIn、Instagram和Facebook的帖子草稿为Markdown文件；它从不出版 |
| [`/akili-review [<pr> | <base>..<head> | --staged]`](https://npmcn.com/package/akili-specs/docs/commands/akili-review.md) | 根据其规格审查拉取请求或差异；只在被问及时发布一个总结评论(`--comment`)或来自CI；它从不编辑、批准或阻止 |

### 在终端

| 命令 | 用它来…… |
| --- | --- |
| `akili init` | 运行安装向导 |
| `akili install` | 在没有向导的情况下安装命令和技能 |
| `akili update` | 更新到最新版本并重新安装文件 |
| `akili list` | 列出包裹所携带的物品 |
| `akili doctor` | 检查所需的文件是否已经安装； `--agents` 检查项目的代理指令文件是否为最新(`--fix` 更新) |
| `akili routing` | 选择哪个人工智能模型运行每个步骤([模型的路由](https://npmcn.com/package/akili-specs/docs/model-routing.md)） |
| `akili check-update` | 如果发布了更新的版本，则打印一行 |
| `akili notifications` | 打开或关闭更新通知（仅限Claude代码） |

每个选项和示例： [文档/ cli.md](https://npmcn.com/package/akili-specs/docs/cli.md).

## 了解更多

| 我想…… | 读 |
| --- | --- |
| 查看每个命令，技能和安装目标在一个地方 | [文档/ overview.md](https://npmcn.com/package/akili-specs/docs/overview.md) |
| 浏览所有文档 | [文档/ README.md](https://npmcn.com/package/akili-specs/docs/README.md) |
| 跟着整个流程，一步一步来 | [文档/ flow.md](https://npmcn.com/package/akili-specs/docs/flow.md) |
| 查找一个命令 | [文档/命令/ README.md](https://npmcn.com/package/akili-specs/docs/commands/README.md) |
| 查找一项技能 | [文档/技能/ README.md](https://npmcn.com/package/akili-specs/docs/skills/README.md) |
| 用Impeccable查看产品的设计，或者查看AKILI提供的第三方技能、许可证和别针 | [文档/技能/ impeccable-bridge.md](https://npmcn.com/package/akili-specs/docs/skills/impeccable-bridge.md)， [文档/技能/ impeccable.md](https://npmcn.com/package/akili-specs/docs/skills/impeccable.md) |
| 使用终端工具或修复安装 | [文档/ cli.md](https://npmcn.com/package/akili-specs/docs/cli.md) |
| 为每一步选择AI模型 | [文档/ model-routing.md](https://npmcn.com/package/akili-specs/docs/model-routing.md) |
| 知道如何选择和保存技能 | [文档/技能/ governance.md](https://npmcn.com/package/akili-specs/docs/skills/governance.md) |
| 比较AKILI和OpenSpec | [文档/ openspec-comparison.md](https://npmcn.com/package/akili-specs/docs/openspec-comparison.md) |
| 在没有任何安装的MCP客户端上使用AKILI（托管AKILI MCP服务，尚未上线） | [akili.com.co](https://akili.com.co/) |

## 贡献与许可

贡献:看 [CONTRIBUTING.md](https://npmcn.com/package/akili-specs/CONTRIBUTING.md);发布遵循 [文档/ release-checklist.md](https://npmcn.com/package/akili-specs/docs/release-checklist.md). 创建和维护的 **胡安·卡洛斯·卡达维德** - - - - - - [jcadavid.com](https://jcadavid.com/)． 根据 [MIT许可证](https://npmcn.com/package/akili-specs/LICENSE). 每个命令和每个代理模板都带有此作者身份通知。 该许可证允许您使用、修改和重新分发AKILI，前提是保留版权和归属通知。 **第三方组件。** AKILI船只 [无可挑剔的](https://github.com/pbakaus/impeccable) 由Paul Bakaus （Apache-2.0）作为 `impeccable` 技能，未修改出售，除了声明的frontmatter块，其 `LICENSE` 和 `NOTICE` 在它的旁边。AKILI-SPECS不隶属于Impeccable项目；看到 [文档/技能/ impeccable.md](https://npmcn.com/package/akili-specs/docs/skills/impeccable.md).

## 常见问题

### akili-specs 是什么？

用于人工智能辅助开发的便携式AKILI-SPECS方法命令和技能。

### 如何安装 akili-specs？

在项目目录运行 npm install akili-specs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 akili，可以用 npx akili 直接运行。

### akili-specs 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/akili-specs 是否存在。

### akili-specs 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### akili-specs 可以商用吗？

akili-specs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### akili-specs 还在维护吗？

最新版本 2\.42\.0 发布于 2026/11/03（今天）；至今共发布 77 个版本，其中过去 12 个月发布了 77 个；首次发布于 2026/07/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。