akili-specs

中文文档
2.42.0发布于 2026/11/03MIT零依赖

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

中文使用文档
文档目录12 节
  1. 什么是AKILI?
  2. 它是如何工作的
  3. 安装
  4. 你需要什么?
  5. 安装
  6. 检查是否有效
  7. 你的第一个规格
  8. 命令概览
  9. 在你的AI助手中
  10. 在终端
  11. 了解更多
  12. 贡献与许可
 █████╗ ██╗  ██╗██╗██╗     ██╗
██╔══██╗██║ ██╔╝██║██║     ██║
███████║█████╔╝ ██║██║     ██║
██╔══██║██╔═██╗ ██║██║     ██║
██║  ██║██║  ██╗██║███████╗██║
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚══════╝╚═╝

AKILI

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

npm version License MIT Node.js 18+

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

什么是AKILI?

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

你得到了什么

  • 助手在每个会话中读取的共享项目上下文。
  • 每个变更都以书面形式计划,并可追溯到需求。
  • 在任何事情被称为完成之前,内置审查和测试。
  • 一种从每次完成的更改中学习的方法。
  • 附加的安全审计、视频、图表和增长轨迹(/akili-seo, /akili-marketing):见 概述.
术语意义
削减命令您在助手中键入的提示,例如 /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.

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

安装

你需要什么?

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

安装

npx akili-specs init

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

检查是否有效

npx akili-specs doctor

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

其他工具、标志、手动安装、更新和故障排除:参见 文档/ cli.md.

你的第一个规格

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

  1. /akili-constitutionAKILI研究您的项目并编写基线文档和指南,例如 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.

命令概览

在你的AI助手中

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

在终端

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

每个选项和示例: 文档/ cli.md.

了解更多

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

贡献与许可

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

版本与发布记录

akili-specs 共发布 77 个版本,首次发布于 2026/07/18;过去 12 个月发布了 77 个版本。

版本发布日期距今
2.42.0latest2026/11/03今天
2.41.02026/11/021 天前
2.40.02026/10/313 天前
2.39.02026/10/303 天前
2.38.02026/10/295 天前
2.37.22026/10/286 天前

关于 akili-specs 的常见问题

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 和提交记录判断。