█████╗ ██╗ ██╗██╗██╗ ██╗ ██╔══██╗██║ ██╔╝██║██║ ██║ ███████║█████╔╝ ██║██║ ██║ ██╔══██║██╔═██╗ ██║██║ ██║ ██║ ██║██║ ██╗██║███████╗██║ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚══════╝╚═╝
AKILI
AI编码助手的规范驱动开发:计划变更,构建变更,测试变更,并从中学习。
适用于Claude Code·OpenCode·谷歌Antigravity·OpenAI Codex CLI·Cursor·Grok Bot -在macOS, Linux和Windows上
什么是AKILI?
AKILI将斜杠命令和技能添加到您的AI编码助手。 它让助手在编写代码之前编写规范,然后构建更改,测试它并根据该规范检查工作。 每次改变之后,它都会学习下次如何做得更好。
你得到了什么
- 助手在每个会话中读取的共享项目上下文。
- 每个变更都以书面形式计划,并可追溯到需求。
- 在任何事情被称为完成之前,内置审查和测试。
- 一种从每次完成的更改中学习的方法。
- 附加的安全审计、视频、图表和增长轨迹(
/akili-seo,/akili-marketing):见 概述.
| 术语 | 意义 |
|---|---|
| 削减命令 | 您在助手中键入的提示,例如 /akili-propose,它运行方法的一个步骤。 |
| 技能 | 助手在工作需要时加载的可重用指令集,例如调试或UI设计。 |
| 规范 | 一个更改的文档文件夹:需求,设计和任务列表,在任何代码之前编写。 |
| 宪法 | 项目范围内的基线(产品、设计和技术文档,加上助手阅读的指南)设置一次。 |
它是如何工作的
- 设置项目一次
/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.
你的第一个规格
在你的人工智能助手中按顺序运行这些:
/akili-constitutionAKILI研究您的项目并编写基线文档和指南,例如docs/prd.md./akili-propose <name>你描述变化,AKILI写一个简短的建议,proposal.md./akili-specify <spec-path>: AKILI计划在requirements.md,design.md和tasks.md./akili-execute <spec-path>: AKILI逐个构建已批准的任务并记录工作execution.md./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.