Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,32 @@
# AGENTS.md — @ultime/cli

> 给在本仓库工作的 AI 与协作者:只放入口与红线,不复述 README。
> 给在本仓库工作的 AI 与协作者:入口、可写 / 只读、红线与验收。
> 适用版本:0.1.x

## 先读

1. [`README.md`](./README.md) — 通用设施 API 与边界。
2. [`rules/README.md`](./rules/README.md) — 本包开发规范。
3. [`llms.txt`](./llms.txt) — AI 索引;能力表见 [`skills.md`](./skills.md),操作约束见 [`agent.md`](./agent.md)。
3. [`llms.txt`](./llms.txt) — AI 索引;能力表见 [`SKILLS.md`](./SKILLS.md)。
4. [`src/run.ts`](./src/run.ts) — 命令注册与退出码。

## 可写 / 只读

| 路径 | 条件 |
|---|---|
| `src/args.ts` / `src/context.ts` / `src/run.ts` | 通用设施;保持零依赖 |
| `src/index.ts` | 公共出口;新增 API 同步 README / `SKILLS.md` |
| `tests/**` | 与 API 改动同批 |
| `rules/` / `llms.txt` / `SKILLS.md` | 随版本同批更新 |

只读:`node_modules/**`;调用方包的源码与产物。

## 红线

- **零领域依赖**:不 import 任何领域包;不内置具体命令。
- **不做 IO 策略**:读盘写盘与配置路径由命令自己决定。
- **不引第三方解析库**:`parseArgs` 保持零依赖。
- **API 变化同步**:`runCli` / `ParsedArgs` / `CliContext` 变化时同步 README、`skills.md` 与测试。
- **API 变化同步**:`runCli` / `ParsedArgs` / `CliContext` 变化时同步 README、`SKILLS.md` 与测试。

## 验证

Expand Down
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# Changelog

## 0.1.3 - 2026-11-10

- 修复 `--key=value` 的值含等号时被截断:`--define=KEY=VALUE` 现在完整保留。
- 包内新增 `llms.txt` / `SKILLS.md` 作为消费侧 AI 入口;`rules/` 留仓,操作约束并入 `AGENTS.md`。

## 0.1.2 - 2026-11-09

- 移除仓库内遗留的 `bin/ultime.js`:它不是本包的公开入口,引用的路径也已不存在。
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
- CLI 只做参数 / 路径 / IO / 退出码;配置合法性与产物内容归调用方包。
- 不 import 任何调用方包的源码,只通过公开包名与 exports 依赖。
- 不自维护具体项目的字段清单;`schema` 之类由调用方投影。
- 新增命令或退出码:同步 README、`skills.md`、测试与版本戳。
- 新增命令或退出码:同步 README、`SKILLS.md`、测试与版本戳。

## Review

Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ process.exitCode = runCli(spec, process.argv.slice(2), processContext())

`parseArgs` 只认 `command`、`--flag`、`--key value` / `--key=value`;`-h/--help` 与 `-v/--version` 是保留 flag。

AI 入口:[`llms.txt`](./llms.txt)(路由)与 [`SKILLS.md`](./SKILLS.md)(能力表)随包发布。

## 边界

- **零领域依赖**:不 import 任何领域包,也不认识具体业务对象。
Expand Down
File renamed without changes.
39 changes: 0 additions & 39 deletions agent.md

This file was deleted.

5 changes: 1 addition & 4 deletions llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,7 @@
## 去哪找

- 怎么用:[README.md](./README.md)
- 开发规则:[rules/README.md](./rules/README.md)
- 可调用能力:[skills.md](./skills.md)
- 操作约束:[agent.md](./agent.md)
- 仓库入口:[AGENTS.md](./AGENTS.md)
- 可调用能力:[SKILLS.md](./SKILLS.md)

## 机器入口

Expand Down
6 changes: 4 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@ultime/cli",
"version": "0.1.2",
"version": "0.1.3",
"description": "Ultime · cli:通用命令行设施(参数 / 命令注册 / 上下文 / 退出码),零领域依赖",
"keywords": [
"argument-parser",
Expand All @@ -24,6 +24,8 @@
"dist",
"src",
"README.md",
"llms.txt",
"SKILLS.md",
"CHANGELOG.md",
"CONTRIBUTING.md",
"SECURITY.md"
Expand All @@ -49,7 +51,7 @@
"@types/node": "^22.20.5",
"tsx": "^4.23.15",
"typescript": "^5.9.3",
"vite-plus": "1.4.0"
"vite-plus": "1.5.1"
},
"engines": {
"node": ">=22.18"
Expand Down
Loading
Loading