kimi-dev-workflow 0.1.0__tar.gz

kimi_dev_workflow-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Git
+node_modules/
+dist/
+build/
+coverage/
+*.log
+.DS_Store
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# 临时文件
+*.tmp
+*.temp
+.grepai/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+.eggs/
+*.whl
+*.tar.gz
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# 发布产物（由 CI 生成）
+/dist/
+/build/

kimi_dev_workflow-0.1.0/.grepaiignore

@@ -0,0 +1,97 @@
+# Auto-generated by kimi-dev-workflow
+# 排除不需要索引的文件，加速 embedding 构建
+
+# ========== 构建产物 ==========
+node_modules/
+dist/
+build/
+coverage/
+
+# ========== 版本控制 ==========
+.git/
+
+# ========== IDE/编辑器 ==========
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# ========== 日志 ==========
+*.log
+npm-debug.log*
+
+# ========== 测试文件 ==========
+*.test.ts
+*.test.tsx
+*.test.js
+*.test.jsx
+*.spec.ts
+*.spec.tsx
+*.spec.js
+*.spec.jsx
+__tests__/
+*.mock.ts
+*.mock.tsx
+*.mock.js
+*.mock.jsx
+
+# ========== 样式文件（语义价值低）==========
+*.css
+*.scss
+*.less
+*.sass
+
+# ========== 配置文件 ==========
+*.config.js
+*.config.ts
+vite.config.*
+tsconfig*.json
+.eslintrc*
+.prettierrc*
+postcss.config.*
+tailwind.config.*
+
+# ========== 文档（语义价值低）==========
+*.md
+README*
+CHANGELOG*
+LICENSE*
+
+# ========== Wiki 知识库（语义价值高）==========
+!wiki/**/*.md
+!.kimi/wiki/**/*.md
+
+# ========== Agent 记忆（语义价值高）==========
+!.kimi/memory.md
+
+# ========== 静态资源 ==========
+public/
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.svg
+*.ico
+*.woff
+*.woff2
+*.ttf
+*.eot
+
+# ========== 自动生成的类型文件 ==========
+*.d.ts
+
+# ========== 项目特定（按需修改）==========
+# 自动生成的图标
+# src/components/icons/
+
+# shadcn/ui 等标准组件库
+# src/components/ui/
+
+# 富文本编辑器（第三方复杂逻辑）
+# src/editor/
+
+# 遗留代码
+# src/legacy/
+
+# mock 数据
+# src/mocks/

kimi_dev_workflow-0.1.0/.kimi/README.md

@@ -0,0 +1,144 @@
+# 🚀 Kimi Dev Workflow — 项目工作流指南
+
+## 常用快捷命令
+
+在 Kimi CLI 中（输入 `kimi` 后）：
+
+| 命令 | 作用 |
+|------|------|
+| `/plan` | 让 AI 先制定计划再执行 |
+| `/compact` | 压缩对话历史，释放上下文窗口 |
+| `/mcp` | 查看已加载的 MCP 工具 |
+| `/help` | 查看所有命令 |
+
+## 文件投喂策略
+
+### ✅ 精准投喂（推荐）
+只给 AI 必要的文件，节省 token，提高精度：
+
+```
+> 帮我看一下 @src/pages/login.tsx 的登录逻辑
+> 搜索所有处理 JWT token 刷新的代码
+> 参照 @src/pages/list.tsx 新增一个详情页
+```
+
+### ❌ 避免全量投喂
+```
+> 帮我改一下 @.     ← 不要这样，浪费 token，效果差
+```
+
+## Prompt 模板使用
+
+项目目录下有 `.kimi/prompts/` 存放常用 prompt 模板：
+
+| 模板 | 场景 |
+|------|------|
+| `01-search.md` | 代码搜索与分析 |
+| `02-code.md` | 新代码编写 |
+| `03-refactor.md` | 代码重构 |
+| `04-debug.md` | Bug 调试 |
+| `05-review.md` | 代码审查 |
+| `06-wiki.md` | 基于 Wiki 知识开发 |
+| `07-memory.md` | 基于记忆的智能开发 |
+
+**使用方式：** 打开文件，复制对应模板，替换 `{}` 中的变量。
+
+## 索引管理
+
+```bash
+# 启动索引（后台运行）
+kimi-index start
+
+# 查看状态
+grepai status
+
+# 手动搜索
+grepai search "关键词"
+
+# 停止索引
+kimi-index stop
+```
+
+## Wiki 知识库
+
+```bash
+# 初始化 Wiki（本地或从远程克隆）
+kimi-wiki init
+kimi-wiki init https://github.com/user/repo.wiki.git
+
+# 同步远程 Wiki 更新
+kimi-wiki sync
+
+# 列出所有 Wiki 页面
+kimi-wiki list
+
+# 语义搜索 Wiki
+kimi-wiki search "订单状态机"
+```
+
+## 开发流程示例
+
+### 新增一个页面
+
+```bash
+# 1. 进入项目
+cd your-project
+
+# 2. 启动 Kimi CLI
+kimi
+
+# 3. 先让 AI 理解现有模式（自动搜索 memory.md 和 wiki）
+> 帮我看一下订单模块的路由和页面结构
+
+# 4. 精准投喂参考文件
+> 参照 @src/pages/orders/list.tsx 和 @src/router/orders.ts
+> 我要新增一个批量操作的页面
+
+# 5. AI 会搜索相关代码，给出完整方案
+# 6. 确认后执行（--yolo 模式自动批准）
+# 7. AI 自动将学到的模式记录到 .kimi/memory.md
+```
+
+### 排查 bug
+
+```bash
+kimi
+
+# 1. 描述现象
+> 订单列表页筛选后数据不更新，帮我排查
+
+# 2. AI 自动搜索相关代码和踩坑记录
+# 3. 定位问题，给出修复方案
+# 4. AI 自动记录踩坑经验到 .kimi/memory.md
+```
+
+### 利用记忆提升效率
+
+```bash
+kimi
+
+# 第一次：明确偏好
+> 帮我新增用户模块，我偏好用 Zustand 做状态管理
+# AI 完成并记录偏好到 .kimi/memory.md
+
+# 第二次：直接复用偏好
+> 帮我新增订单模块
+# AI 自动搜索 memory.md，发现用户偏好 Zustand
+# 直接给出符合用户习惯的方案，无需再次确认
+```
+
+## 性能优化
+
+### 上下文窗口管理
+- 长会话 (>20 轮) 后用 `/compact` 压缩
+- 精准 @ 文件，不要全量投喂
+- 复杂任务拆分成多轮对话
+
+### 索引加速
+- 使用 `all-minilm:l6-v2`（22MB，比默认快 3-5 倍）
+- 配置 `.grepaiignore` 排除无关文件
+- 只索引 `src/` 核心代码
+
+---
+
+*项目工作流指南 v1.0*

kimi_dev_workflow-0.1.0/.kimi/memory.md

@@ -0,0 +1,53 @@
+# 🤖 Agent 记忆库
+
+> 本文件由 Agent 自动维护，记录项目开发过程中的学习、决策和偏好。
+> 每次完成重要任务后，Agent 会在对应章节追加新的记忆条目。
+> 开始新任务前，Agent 应优先搜索本文件获取历史上下文。
+
+---
+
+## 👤 用户偏好
+
+### 编码风格
+- （示例）偏好函数式组件，禁止 class 组件
+- （示例）Hooks 命名统一用 `useXxx`，工具函数用 `camelCase`
+
+### 架构倾向
+-
+
+### 技术偏好
+-
+
+---
+
+## 📋 决策记录
+
+| 时间 | 场景 | 决策 | 原因 | 验证结果 |
+|------|------|------|------|----------|
+|      |      |      |      |          |
+
+---
+
+## 🐛 踩坑记录
+
+| 时间 | 问题 | 根因 | 解决方案 | 相关文件 |
+|------|------|------|----------|----------|
+|      |      |      |          |          |
+
+---
+
+## 🔍 发现的模式
+
+| 时间 | 模式描述 | 适用场景 | 示例/出处 |
+|------|----------|----------|-----------|
+|      |          |          |           |
+
+---
+
+## 📌 快速参考
+
+### 新增 XX 的标准流程
+1.
+
+### 常见问题的快速解法
+-

kimi_dev_workflow-0.1.0/.kimi/prompts/01-search.md

@@ -0,0 +1,24 @@
+# 🔍 代码搜索与分析
+
+## 场景：理解某个业务逻辑
+
+我想理解 {业务模块} 的代码逻辑，请帮我：
+1. 找到相关的核心文件（组件、hooks、API）
+2. 梳理数据流和状态管理
+3. 说明关键的业务规则
+
+## 场景：查找某个函数/组件的定义和使用
+
+请帮我找到 {函数名/组件名} 的定义位置，以及所有调用它的地方。
+
+## 场景：理解跨模块的数据流转
+
+{模块A} 和 {模块B} 之间是怎么传递数据的？帮我梳理完整的数据流。
+
+## 场景：找 bug 的根因
+
+{问题描述}，帮我分析可能的根因，重点检查：
+1. 状态更新逻辑
+2. 异步请求处理
+3. 条件渲染/边界情况
+4. 类型定义是否匹配实际数据

kimi_dev_workflow-0.1.0/.kimi/prompts/02-code.md

@@ -0,0 +1,33 @@
+# ✨ 代码编写
+
+## 场景：新页面开发
+
+我要在 {模块路径} 下新增一个 {页面功能} 页面，请帮我：
+1. 参照同模块的现有页面，确定路由、文件结构
+2. 使用现有的数据获取模式
+3. 复用已有的业务组件
+4. 遵循已有的表单校验和错误处理模式
+
+## 场景：新增组件
+
+我需要创建一个 {组件功能} 组件，要求：
+1. 放在 {components/xxx} 下
+2. Props 接口定义完整
+3. 支持受控和非受控两种模式（如适用）
+4. 参照 {参照组件路径} 的风格和接口设计
+
+## 场景：新增 API 接口
+
+我需要调用 {后端接口}，请帮我：
+1. 在正确位置新增 API 函数
+2. 定义请求/响应类型
+3. 使用统一的错误处理
+4. 如有需要，新增对应的状态管理 action
+
+## 场景：新增路由
+
+我要新增一个 {路由路径} 的页面，请帮我：
+1. 在对应模块的路由配置中添加
+2. 创建页面组件文件
+3. 更新导航菜单配置（如需要）
+4. 添加路由参数类型定义（如有动态参数）

kimi_dev_workflow-0.1.0/.kimi/prompts/03-refactor.md

@@ -0,0 +1,29 @@
+# 🔧 代码重构
+
+## 场景：提取公共逻辑到 hooks
+
+这段代码 {代码片段} 在多个地方重复，请帮我：
+1. 提取为自定义 hook，放在合适位置
+2. 保持现有行为不变
+3. 更新所有使用处
+
+## 场景：组件拆分
+
+这个组件 {组件路径} 太大了，请帮我拆分为：
+1. 容器组件（数据获取、状态管理）
+2. 展示子组件（纯 UI）
+3. 保持 props 接口清晰
+
+## 场景：状态管理优化
+
+这个模块的状态管理有点混乱，请帮我：
+1. 分析当前状态分布
+2. 区分全局/局部状态
+3. 提出最佳分配方案
+
+## 场景：类型安全提升
+
+这段代码有很多 any / 类型断言，请帮我：
+1. 补齐类型定义
+2. 移除不必要的类型断言
+3. 处理可能的 null/undefined

kimi_dev_workflow-0.1.0/.kimi/prompts/04-debug.md

@@ -0,0 +1,34 @@
+# 🐛 Bug 修复
+
+## 场景：功能异常
+
+{功能描述} 不工作了，表现为：{错误现象}
+请帮我：
+1. 定位相关代码
+2. 分析可能的根因
+3. 提供修复方案
+4. 检查是否有其他受影响的地方
+
+## 场景：性能问题
+
+{页面/组件} 加载/响应很慢，请帮我：
+1. 分析可能的性能瓶颈
+2. 检查是否有不必要的重渲染
+3. 检查 API 请求是否可优化
+4. 提供优化方案
+
+## 场景：类型错误
+
+TypeScript 报错：{错误信息}
+请帮我：
+1. 定位报错的代码位置
+2. 分析类型不匹配的原因
+3. 提供正确的类型定义
+
+## 场景：测试失败
+
+{测试文件} 测试失败了，错误是：{错误信息}
+请帮我：
+1. 分析失败原因
+2. 修复测试或修复代码
+3. 检查是否有遗漏的测试场景

kimi_dev_workflow-0.1.0/.kimi/prompts/05-review.md

@@ -0,0 +1,31 @@
+# 📋 代码审查
+
+## 场景：PR 审查
+
+请审查这段代码变更：
+{diff 或文件路径}
+
+关注：
+1. 业务逻辑正确性
+2. 边界情况处理
+3. 类型安全
+4. 是否遵循项目规范（AGENTS.md）
+5. 是否有更好的实现方式
+
+## 场景：接口设计审查
+
+我要新增一个 API 接口 / 组件接口，请帮我审查：
+{接口定义}
+
+关注：
+1. 命名是否清晰
+2. 参数是否完整
+3. 错误处理是否充分
+4. 是否和现有接口风格一致
+
+## 场景：依赖升级影响
+
+我要升级 {依赖名} 从 {旧版本} 到 {新版本}，请帮我：
+1. 检查 breaking changes
+2. 评估对本项目的影响范围
+3. 提供迁移方案

kimi_dev_workflow-0.1.0/.kimi/prompts/06-wiki.md

@@ -0,0 +1,22 @@
+# 📖 基于 Wiki 知识开发
+
+## 场景：理解业务背景后修改代码
+
+我要修改 {模块/功能}，相关背景知识请搜索 wiki：
+1. 搜索 wiki 中关于 {业务概念} 的说明
+2. 结合代码理解当前实现
+3. 确保修改符合业务规则和架构约定
+
+## 场景：新功能开发（需符合现有约定）
+
+我要新增 {功能}，请帮我：
+1. 搜索 wiki 中的相关架构/约定文档
+2. 参照现有代码模式
+3. 确保遵循项目规范和业务规则
+
+## 场景：排查涉及业务逻辑的问题
+
+{问题描述}，请帮我：
+1. 搜索 wiki 了解相关业务规则和预期行为
+2. 对比代码实现与业务规则是否一致
+3. 定位并修复问题

kimi_dev_workflow-0.1.0/.kimi/prompts/07-memory.md

@@ -0,0 +1,32 @@
+# 🧠 基于记忆的智能开发
+
+## 场景：开始新任务前获取上下文
+
+我要处理 {任务描述}，请帮我：
+1. 搜索 `.kimi/memory.md` 中的相关历史记录
+2. 了解用户的偏好和过往决策
+3. 基于记忆给出最佳方案
+
+## 场景：完成任务后更新记忆
+
+我刚完成了 {任务}，关键信息如下：
+- 决策/变更：{描述}
+- 原因：{描述}
+- 踩到的坑：{描述}
+
+请帮我更新 `.kimi/memory.md`，追加到对应章节。
+
+## 场景：排查重复出现的问题
+
+{问题描述}，请帮我：
+1. 搜索 `.kimi/memory.md` 的踩坑记录
+2. 搜索 wiki 中的相关知识
+3. 给出根因分析和修复方案
+
+## 场景：总结当前会话的学习
+
+请总结本次对话中的关键学习，并更新 `.kimi/memory.md`：
+- 做出的重要决策
+- 发现的模式或约定
+- 用户的偏好表达
+- 踩到的坑及解决方式

kimi_dev_workflow-0.1.0/AGENTS.md

@@ -0,0 +1,109 @@
+# kimi-dev-workflow — 项目架构与开发规范
+
+## 📦 技术栈
+
+| 层 | 技术 |
+|---|---|
+| 框架 | Python + hatchling |
+| 构建 | hatchling |
+| 状态 | — |
+| 路由 | — |
+| 样式 | — |
+| HTTP | requests / httpx |
+| 校验 | pydantic |
+| 表单 | — |
+
+## 🗂️ 目录结构速查
+
+```
+src/
+├── pages/            ← 页面组件（路由对应）
+├── components/       ← 复用组件
+│   ├── ui/          ← 基础 UI 组件（Button/Dialog/Table 等）
+│   └── business/    ← 业务组件
+├── hooks/            ← 自定义 Hooks
+├── stores/           ← 状态管理（Zustand/Redux）
+├── api/              ← API 层 / 接口定义
+├── utils/            ← 工具函数
+├── router/           ← 路由配置
+└── types/            ← 全局类型定义
+```
+
+## 🎯 核心开发模式
+
+### 路由模式
+{描述你的路由组织方式，如：每个模块独立 router.tsx，在根路由汇总}
+
+### 状态管理模式
+{描述状态分层策略，如：全局用 Zustand，局部用 React Context}
+
+### API 请求模式
+{描述数据获取封装，如：统一 useQueryAction / TanStack Query}
+
+### 表单模式
+{描述表单处理，如：react-hook-form + zod 校验}
+
+## 📝 编码规范
+
+1. **组件**：函数式组件 + Hooks
+2. **状态**：
+   - 全局共享 → —
+   - 模块内 → —
+   - 禁止直接修改 store state，必须通过 action
+3. **API**：统一走封装层，错误处理用统一 自定义 Exception
+4. **类型**：接口定义优先用 `interface`，表单 schema 用 pydantic
+
+## 🔍 常见问题定位
+
+| 问题 | 定位路径 |
+|---|---|
+| 路由跳转失败 | src/ |
+| 全局状态不更新 | — |
+| API 请求报错 | src/ |
+| 认证问题 | — |
+| 布局异常 | — |
+
+## 📚 Wiki 知识库
+
+项目维护了一份本地 Wiki，包含业务规则、架构决策、开发约定等知识：
+
+- 位置：`wiki/` 目录
+- 格式：Markdown
+- 索引状态：已通过 grepai 建立语义索引
+
+**当你需要理解以下内容时，请优先搜索 Wiki：**
+- 业务规则、领域概念
+- 架构决策、模块边界
+- API 约定、数据格式
+- 部署配置、环境差异
+
+搜索方式：使用 grepai MCP 工具进行语义搜索，或让用户执行 `kimi-wiki search "关键词"`
+
+## 🧠 Agent 记忆与学习
+
+项目维护了一份记忆文件 `.kimi/memory.md`，记录开发过程中的关键学习：
+
+### 何时更新记忆
+每次完成涉及以下内容的任务后，请在 `.kimi/memory.md` 中追加记录：
+- 代码架构或设计模式的变更
+- 重要的技术决策及原因
+- 踩过的坑及解决方案
+- 用户的明确偏好（编码风格、命名习惯、技术倾向等）
+- 发现的重复模式或最佳实践
+
+### 何时读取记忆
+开始新任务前，请先搜索 `.kimi/memory.md` 获取相关上下文：
+- 涉及类似模块时，查看是否有历史决策
+- 遇到报错时，查看踩坑记录
+- 不确定用户偏好时，查看用户偏好部分
+- 需要遵循既有模式时，查看发现的模式
+
+### 更新格式要求
+- 追加到对应章节，不要覆盖已有内容
+- 时间格式：YYYY-MM-DD
+- 保持简洁，一条记忆不超过 3 行
+
+Global Rules:
+- 所有 AI 输出使用简体中文
+- 代码修改后保留原有注释和格式化风格
+- 涉及路由变更时同步更新 —

kimi_dev_workflow-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.