@jun133/kitty 0.0.1 → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -8
- package/dist/cli.js +2794 -2113
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -32,11 +32,11 @@
|
|
|
32
32
|
| --- | --- |
|
|
33
33
|
| 🧭 Agent 循环 | 模型、工具、session、收尾都在同一个主循环里推进 |
|
|
34
34
|
| 🧠 Context | 项目上下文、运行时上下文、工作记忆、长上下文压缩 |
|
|
35
|
-
| 💾 Session | 会话记录、checkpoint、todo
|
|
35
|
+
| 💾 Session | 会话记录、checkpoint、todo、恢复现场、结构化可审阅 memory 文件 |
|
|
36
36
|
| 🔌 Provider | OpenAI-compatible provider、请求恢复、连接诊断 |
|
|
37
37
|
| 🛠️ Core tools | `read`、`edit`、`write`、`bash` |
|
|
38
38
|
| 🧩 Extensions | `todo`、`worktree`、`network`、`background`、`subagent`、`team`、`skills`、`spec` |
|
|
39
|
-
| 🧾 Control plane | SQLite
|
|
39
|
+
| 🧾 Control plane | SQLite 账本记录 task lifecycle、execution、deadline、输出健康、wait policy、pid、状态和 wake 事实；host 负责等待和恢复 lead |
|
|
40
40
|
| 📐 Spec 模式 | `requirements.md`、`design.md`、`tasks.md`、`notes.md` 和隔离 worktree |
|
|
41
41
|
| 💬 产品面 | CLI、交互终端、Telegram 私聊服务 |
|
|
42
42
|
| 📎 证据记录 | 事件、终端日志、崩溃记录、文件变更记录 |
|
|
@@ -85,7 +85,7 @@ kitty spec
|
|
|
85
85
|
| `kitty sessions` | 查看最近会话 |
|
|
86
86
|
| `kitty config show` | 查看从 `.kitty/.env` 解析出的当前运行配置 |
|
|
87
87
|
| `kitty config path` | 查看当前项目 `.kitty/.env` 路径 |
|
|
88
|
-
| `kitty status` | 查看当前项目 runtime 现场：session、memory、execution、team、wake、spec |
|
|
88
|
+
| `kitty status` | 查看当前项目 runtime 现场：session、task lifecycle、memory、execution、deadline、team、wake、spec |
|
|
89
89
|
| `kitty memory` | 查看、读取、搜索、删除，或把 session memory 沉淀到 spec notes / skill references |
|
|
90
90
|
| `kitty changes` | 查看记录的文件变更 |
|
|
91
91
|
| `kitty undo [changeId]` | 撤销最近一次或指定变更 |
|
|
@@ -111,16 +111,18 @@ Extension 是可启用、可禁用、独立存在的工具集合：
|
|
|
111
111
|
| `todo` | 会话级 todo 写入和可见 checklist |
|
|
112
112
|
| `worktree` | Git worktree 事实、创建、保留和删除 |
|
|
113
113
|
| `network` | HTTP session、请求、探测、下载、trace、OpenAPI 检查 |
|
|
114
|
-
| `background` |
|
|
115
|
-
| `subagent` |
|
|
116
|
-
| `team` | teammate
|
|
117
|
-
| `skills` | 项目运行时 skill
|
|
118
|
-
| `spec` | durable spec 文档、状态、任务、checkpoint
|
|
114
|
+
| `background` | 后台命令执行、运行输出摘要、deadline、last output、检查、终止和生命周期记录 |
|
|
115
|
+
| `subagent` | 聚焦子执行启动、派工边界、deadline、状态检查、worker 结论回传、wait policy、lead 挂起与 wake 恢复 |
|
|
116
|
+
| `team` | teammate 注册、派工边界、deadline、执行、消息、inbox、worker 结论回传、wait policy、lead 挂起与成员状态收束 |
|
|
117
|
+
| `skills` | 项目运行时 skill 包索引、正文加载、资源读取和脚本运行；使用事实进入 observability 和 task lifecycle |
|
|
118
|
+
| `spec` | durable spec 文档、状态、任务、checkpoint、隔离 worktree，并把 spec stage 接入 task lifecycle |
|
|
119
119
|
|
|
120
120
|
默认 agent 会启用 `todo`、`worktree`、`network`、`background`、`subagent`、`team`、`skills`。`spec` 不随默认 agent 自动启用；需要 spec 工作流时使用 `kitty spec`。
|
|
121
121
|
|
|
122
122
|
Runtime skills 放在项目 `SKILL.md`、`.skills/**/SKILL.md` 或 `skills/**/SKILL.md`。默认上下文只显示 skill 名称、说明和路径；完整正文必须由模型明确调用 `skill_load` 后进入当前轮。Skill 包内的 `references/`、`scripts/`、`examples/` 和 `assets/` 会作为资源索引出现，需要时用 `skill_read_resource` 读取资源，或用 `skill_run_script` 运行已声明的 `scripts/` 资源。Skill frontmatter 可用 `requires` 声明命令依赖，运行时用 `skill_check` 检查。`.codex/skills/**` 是 Codex 维护本仓库用的开发规范，不属于小猫运行时 skill。
|
|
123
123
|
|
|
124
|
+
Session memory 由模型在 turn 收口时按固定 Markdown 区块写出：`Current Objective`、`User Constraints`、`Decisions`、`Open Threads`、`Verification Facts`、`Reusable Lessons`。机器只维护格式和保存边界，不替模型判断事实重要性。
|
|
125
|
+
|
|
124
126
|
Memory 资产可以用 `kitty memory <sessionId> --append-to-spec <specId>` 追加到 spec `notes.md`，也可以用 `kitty memory <sessionId> --append-to-skill <skillName>` 写入该 skill 的 `references/`。这两条路径只沉淀已保存事实，不替模型判断哪些经验值得复用。
|
|
125
127
|
|
|
126
128
|
查看配置：
|