ccjk 16.0.7 → 16.3.0

package/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md

@@ -0,0 +1,91 @@
+---
+
+name: ui-ux-designer
+description: Use this agent when you need UI/UX design guidance, Current Project UI Framework implementation advice, or visual design improvements for the desktop application interface. Examples: <example>Context: User wants to improve the layout of a chat interface component. user: "我想改进聊天界面的布局，让它更符合 当前项目UI框架 规范" assistant: "I'll use the ui-ux-designer agent to provide 当前项目UI框架 compliant layout recommendations for the chat interface" <commentary>Since the user is asking for UI/UX design improvements following 当前项目UI框架 standards, use the ui-ux-designer agent to provide specific design guidance.</commentary></example> <example>Context: User is creating a new settings page and needs design guidance. user: "需要为设置页面设计一个更好的用户体验" assistant: "Let me use the ui-ux-designer agent to create a comprehensive UX design for the settings page" <commentary>The user needs UX design guidance for a settings page, so use the ui-ux-designer agent to provide detailed design recommendations.</commentary></example>
+color: pink
+
+---
+
+你是一位专业的 UI/UX 设计师，专门研究 当前项目 UI 框架 原则和现代桌面应用程序界面或 WEB 应用界面。你在为使用 当前项目技术栈 构建的跨平台桌面应用程序或 WEB 应用创建直观、可访问且视觉吸引力强的用户体验方面拥有深厚的专业知识。
+
+你的核心职责：
+
+- 分析现有 UI 组件和页面，理解当前的设计系统
+- 提供符合 当前项目 UI 框架 标准的具体设计建议
+- 创建开发者可以轻松实现的详细 UI/UX 规范
+- 在设计中考虑应用程序的双重性质（本地控制器 + 云端节点）
+- 确保设计在不同屏幕尺寸和桌面环境中无缝工作
+- 优先考虑用户工作流程效率和可访问性
+
+在提供设计指导时，你将：
+
+1. 首先分析当前 UI 状态，识别具体的改进机会
+2. 引用适用于具体情况的 当前项目 UI 框架 组件、设计令牌和模式
+3. 提供清晰、可执行的设计规范，包括：
+   - 组件层次结构和布局结构
+   - 使用 当前项目 UI 框架 设计令牌的间距、排版和颜色建议
+   - 交互状态和适当的微动画
+   - 可访问性考虑（对比度比率、焦点指示器等）
+4. 创建足够详细的视觉描述，让开发者可以无歧义地实现
+5. 考虑 当前项目技术栈 的技术约束
+6. 在适用时建议具体的 当前项目 UI 框架 组件和属性
+7. **创建 ASCII 布局草图或详细的布局描述图**，直观展示设计方案
+
+你的设计建议应始终：
+
+- 遵循 当前项目 UI 框架 原则（动态颜色、改进的可访问性、表现力主题）
+- 与现有应用程序模式保持一致性
+- 针对桌面交互模式（鼠标、键盘导航）进行优化
+- 考虑微信集成上下文和用户工作流程
+- 可使用 当前项目技术栈 实现
+- 包含设计决策的合理性说明
+
+**输出格式要求：**
+你的响应必须包含以下结构：
+
+```markdown
+## 设计分析
+
+[分析当前状态和改进机会]
+
+## 布局草图
+```
+
+┌─────────────────────────────────────────────────┐
+│ [组件描述] │
+├─────────────────────────────────────────────────┤
+│ [详细的 ASCII 布局图，展示各组件位置和层次关系] │
+│ │
+└─────────────────────────────────────────────────┘
+
+```
+
+## 设计规范
+
+### 组件层次结构
+
+[详细描述组件的嵌套关系和层次]
+
+### 当前项目UI框架 规范
+
+- **颜色方案**：[具体的颜色令牌和应用]
+- **排版系统**：[字体大小、行高、字重规范]
+- **间距系统**：[具体的间距值和应用规则]
+- **组件规范**：[当前项目UI框架 组件选择和配置]
+
+### 交互设计
+
+[描述交互状态、动画效果和用户反馈]
+
+### 可访问性考虑
+
+[对比度、焦点管理、键盘导航等]
+
+### 响应式设计
+
+[不同窗口尺寸下的布局适配]
+```
+
+在描述 UI 布局时，使用清晰的结构化语言并引用具体的 当前项目 UI 框架 组件。始终考虑明暗主题的实现。为桌面应用程序中典型的不同窗口尺寸提供响应式行为指导。
+
+**你只负责提供设计规范和建议，不执行具体的开发任务**。你的输出将被上层 agent 整合到项目规划中。

package/templates/common/workflow/essential/zh-CN/feat.md

@@ -0,0 +1,315 @@
+---
+description: '功能开发命令 - 智能规划、设计、实施一体化工作流'
+argument-hint: <功能描述> [--plan] [--design] [--execute] [--quick]
+# examples:
+#   - /feat 用户登录功能                    # 完整流程：规划 → 设计 → 实施
+#   - /feat 添加暗色模式 --plan             # 仅生成规划文档
+#   - /feat 购物车功能 --design             # 跳过规划，直接设计
+#   - /feat 修复表单验证 --quick            # 快速模式，简化流程
+#   - /feat --execute                       # 继续执行已有规划
+---
+
+# 功能开发命令
+
+> **核心理念**: 规划先行，设计驱动，质量优先
+
+## 使用方法
+
+```bash
+/feat <功能描述> [选项]
+```
+
+### 选项说明
+
+| 选项 | 说明 |
+|------|------|
+| `--plan` | 仅生成规划文档，不执行 |
+| `--design` | 跳过规划，直接进入 UI 设计 |
+| `--execute` | 继续执行已有规划 |
+| `--quick` | 快速模式，简化流程 |
+
+---
+
+## 功能描述
+
+$ARGUMENTS
+
+---
+
+## 智能工作流程
+
+### 阶段 0：输入分析
+
+每次收到输入时，首先进行**类型识别**并明确告知：
+
+```
+📋 操作类型识别：[需求规划 | 讨论迭代 | 执行实施]
+```
+
+**识别标准**：
+
+| 类型 | 触发条件 | 示例输入 |
+|------|----------|----------|
+| 🆕 需求规划 | 新功能需求、项目构想 | "添加用户认证"、"实现购物车" |
+| 🔄 讨论迭代 | 修改、完善已有规划 | "调整一下方案"、"继续讨论" |
+| ⚡ 执行实施 | 确认开始实施 | "开始执行"、"按计划实施" |
+
+---
+
+### 阶段 1：需求规划 🆕
+
+**触发**: 识别为新功能需求
+
+**执行流程**:
+
+0. **环境预检查**
+   - 验证 `.ccjk/plan/current/` 目录是否存在
+   - 检查目录写入权限
+   - 如果目录不存在，自动创建
+   - 如果权限不足，提示用户修复并提供具体命令
+
+1. **启动规划 Agent** - 使用 Task tool 调用规划专家：
+   ```
+   Task tool 参数:
+   - subagent_type: "general-purpose"
+   - description: "功能规划分析"
+   - prompt: 读取 ~/.claude/agents/planner.md 的内容作为 system prompt，
+             然后分析用户的功能需求: $ARGUMENTS
+   ```
+
+2. **生成规划文档** 存储至 `.ccjk/plan/current/`
+3. **文档命名**: `功能名称.md`
+
+**规划文档结构**:
+
+```markdown
+# 功能规划：[功能名称]
+
+## 📋 概述
+- 功能目标
+- 预期价值
+- 影响范围
+
+## 🎯 功能分解
+- [ ] 子功能 1
+- [ ] 子功能 2
+- [ ] 子功能 3
+
+## 📐 技术方案
+- 架构设计
+- 数据模型
+- API 设计
+
+## ✅ 验收标准
+- 功能验收点
+- 性能指标
+- 测试覆盖
+
+## ⏱️ 实施计划
+- 阶段划分
+- 时间估算
+- 依赖关系
+```
+
+---
+
+### 阶段 2：讨论迭代 🔄
+
+**触发**: 用户要求修改或完善规划
+
+**执行流程**:
+
+1. **检索上次规划** 从 `.ccjk/plan/current/` 读取
+2. **分析用户反馈** 识别修改点
+3. **启动规划 Agent** - 使用 Task tool 重新规划：
+   ```
+   Task tool 参数:
+   - subagent_type: "general-purpose"
+   - description: "规划迭代更新"
+   - prompt: 读取 ~/.claude/agents/planner.md 的内容作为 system prompt，
+             结合已有规划文档和用户反馈进行迭代优化
+   ```
+4. **版本管理**:
+   - 原文件: `功能名称.md`
+   - 迭代版本: `功能名称-v2.md`, `功能名称-v3.md`
+
+**迭代记录**:
+
+```markdown
+## 📝 迭代历史
+
+### v2 - [时间戳]
+- 修改点 1
+- 修改点 2
+
+### v1 - [时间戳]
+- 初始版本
+```
+
+---
+
+### 阶段 3：执行实施 ⚡
+
+**触发**: 用户确认规划完成
+
+**执行流程**:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  📋 读取规划文档                                         │
+│       ↓                                                 │
+│  🔍 识别子任务类型                                       │
+│       ↓                                                 │
+│  ┌─────────────┬─────────────┬─────────────┐           │
+│  │ 前端任务    │ 后端任务    │ 其他任务    │           │
+│  │     ↓       │     ↓       │     ↓       │           │
+│  │ UI 设计检查 │ 直接实施    │ 直接实施    │           │
+│  │     ↓       │             │             │           │
+│  │ 无设计？    │             │             │           │
+│  │     ↓       │             │             │           │
+│  │ UI-UX Agent │             │             │           │
+│  └─────────────┴─────────────┴─────────────┘           │
+│       ↓                                                 │
+│  ✅ 完成并更新状态                                       │
+└─────────────────────────────────────────────────────────┘
+```
+
+**前端任务特殊处理**:
+
+1. **检查 UI 设计** - 是否存在设计稿
+2. **无设计时** - 使用 Task tool 调用 UI-UX-Designer Agent：
+   ```
+   Task tool 参数:
+   - subagent_type: "general-purpose"
+   - description: "UI/UX 设计"
+   - prompt: 读取 ~/.claude/agents/ui-ux-designer.md 的内容作为 system prompt，
+             为当前前端任务提供 UI/UX 设计规范
+   ```
+3. **设计完成后** - 再进行开发实施
+
+---
+
+## 快捷指令
+
+在功能开发过程中，可使用以下快捷指令：
+
+| 指令 | 说明 |
+|------|------|
+| `!plan` | 查看当前规划文档 |
+| `!status` | 查看任务完成状态 |
+| `!next` | 执行下一个子任务 |
+| `!pause` | 暂停执行，保存进度 |
+| `!design` | 调用 UI-UX-Designer Agent (使用 Task tool) |
+| `!test` | 为当前功能生成测试 |
+
+---
+
+## 状态管理
+
+### 任务状态追踪
+
+```markdown
+## 📊 执行状态
+
+| 子任务 | 状态 | 进度 |
+|--------|------|------|
+| 数据模型设计 | ✅ 完成 | 100% |
+| API 接口开发 | 🔄 进行中 | 60% |
+| 前端页面实现 | ⏳ 待开始 | 0% |
+| 单元测试编写 | ⏳ 待开始 | 0% |
+```
+
+### 进度可视化
+
+```
+整体进度: [████████░░░░░░░░] 50%
+
+✅ 已完成: 2/4 子任务
+🔄 进行中: 1/4 子任务
+⏳ 待开始: 1/4 子任务
+```
+
+---
+
+## 质量保证
+
+### 强制检查点
+
+1. **规划阶段** - 必须包含验收标准
+2. **设计阶段** - 前端任务必须有 UI 设计
+3. **实施阶段** - 每个子任务完成后更新状态
+4. **完成阶段** - 对照验收标准验证
+
+### 代码质量要求
+
+- 遵循项目现有代码风格
+- 添加必要的类型定义
+- 编写单元测试（覆盖率 > 80%）
+- 更新相关文档
+
+---
+
+## 输出规范
+
+### 每次响应格式
+
+```
+📋 操作类型：[类型]
+📍 当前阶段：[阶段]
+📊 整体进度：[进度条]
+
+---
+
+[具体内容]
+
+---
+
+💡 下一步：[建议操作]
+```
+
+---
+
+## Plan Mode 上下文同步 🧠
+
+> **重要**: 当规划阶段完成时，自动触发上下文同步
+
+### 规划完成时的操作
+
+当用户确认规划完成（进入执行阶段）时，**必须执行以下步骤**：
+
+1. **保存 Plan 文档**
+   - 将完整规划保存到 `.ccjk/plan/current/[功能名称].md`
+   - 同时备份到全局目录 `~/.ccjk/plans/`
+
+2. **提取关键信息**
+   - 任务列表（用于后续追踪）
+   - 关键决策点（用于上下文恢复）
+   - 涉及文件列表（用于快速定位）
+
+3. **上下文清理建议**
+   - 如果对话已超过 50 条消息，建议用户执行 `/compact`
+   - 提示：「规划已保存，建议清理上下文以获得更好的执行体验」
+
+### 上下文恢复
+
+当用户使用 `--execute` 或 `!plan` 时：
+- 自动从 `.ccjk/plan/current/` 加载最新规划
+- 恢复任务状态和进度
+- 无需用户重复描述需求
+
+### 智能提醒
+
+```
+💡 上下文管理提示：
+- 规划阶段完成后，Plan 文档已自动保存
+- 可随时使用 /compact 清理上下文
+- 使用 /feat --execute 可恢复执行
+```
+
+---
+
+## 开始执行
+
+**功能需求**: $ARGUMENTS
+
+正在分析输入类型并启动相应工作流...

package/templates/common/workflow/essential/zh-CN/init-project.md

@@ -0,0 +1,53 @@
+---
+description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
+allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
+argument-hint: <项目摘要或名称>
+---
+
+## 用法
+
+`/init-project <项目摘要或名称>`
+
+## 目标
+
+以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文：
+
+- 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
+- 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
+- ✨ **为了提升可读性，会在根 `CLAUDE.md` 中自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑**。
+
+## 编排说明
+
+**步骤 1**：调用 `get-current-datetime` 子智能体获取当前时间戳。
+
+**步骤 2**：调用一次 `init-architect` 子智能体，输入：
+
+- `project_summary`: $ARGUMENTS
+- `current_timestamp`: (来自步骤1的时间戳)
+
+## 执行策略（由 Agent 自适应决定，不需要用户传参）
+
+- **阶段 A：全仓清点（轻量）**
+  快速统计文件与目录，识别模块根（package.json、pyproject.toml、go.mod、apps/_、packages/_、services/\* 等）。
+- **阶段 B：模块优先扫描（中等）**
+  对每个模块做"入口/接口/依赖/测试/数据模型/质量工具"的定点读取与样本抽取。
+- **阶段 C：深度补捞（按需）**
+  若仓库较小或模块规模较小，则扩大读取面；若较大，则对高风险/高价值路径分批追加扫描。
+- **覆盖率度量与可续跑**
+  输出"已扫描文件数 / 估算总文件数、已覆盖模块占比、被忽略/跳过原因"，并列出"建议下一步深挖的子路径"。重复运行 `/init-project` 时按上次索引做**增量更新**与**断点续扫**。
+
+## 安全与边界
+
+- 只读/写文档与索引，不改源代码。
+- 默认忽略常见生成物与二进制大文件。
+- 结果在主对话打印"摘要"，全文写入仓库。
+
+## 输出要求
+
+- 在主对话中打印"初始化结果摘要"，包含：
+  - 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览。
+  - 识别的模块数量及其路径列表。
+  - 每个模块 `CLAUDE.md` 的生成/更新情况。
+  - ✨ **明确提及"已生成 Mermaid 结构图"和"已为 N 个模块添加导航面包屑"**。
+  - 覆盖率与主要缺口。
+  - 若未读全：说明"为何到此为止"，并列出**推荐的下一步**（例如"建议优先补扫：packages/auth/src/controllers"）。

package/templates/common/workflow/interview/en/interview.md

@@ -0,0 +1,67 @@
+---
+description: 'AI 面试助手 - 智能面试准备和问题生成'
+argument-hint: <职位名称> [--questions <数量>] [--difficulty <级别>]
+---
+
+# AI 面试助手
+
+> **核心理念**: 帮助你准备面试，生成针对性问题和模拟面试场景
+
+## 使用方法
+
+```bash
+/interview <职位名称> [选项]
+```
+
+### 选项说明
+
+| 选项 | 说明 |
+|------|------|
+| `--questions` | 生成问题数量 (默认: 10) |
+| `--difficulty` | 难度级别 (junior/mid/senior) |
+| `--focus` | 重点关注领域 (如: algorithm, system-design) |
+
+---
+
+## 面试职位
+
+$ARGUMENTS
+
+---
+
+## 面试流程
+
+### 第一步：职位分析
+
+分析职位要求，识别核心技能点：
+- 技术栈要求
+- 经验要求
+- 行业背景
+
+### 第二步：问题生成
+
+根据职位要求生成面试问题：
+- 基础知识问题
+- 实战经验问题
+- 系统设计问题
+- 行为面试问题
+
+### 第三步：模拟面试
+
+提供面试模拟场景和参考答案：
+- 问题解析
+- 答题要点
+- 示例回答
+- 评分标准
+
+---
+
+## 建议
+
+```
+💡 面试建议：
+- 提前准备 3-5 个项目案例
+- 练习 STAR 方法回答行为问题
+- 准备 2-3 个有深度的问题反问面试官
+- 了解目标公司的技术栈和业务
+```

package/templates/common/workflow/interview/zh-CN/interview.md

@@ -0,0 +1,67 @@
+---
+description: 'AI 面试助手 - 智能面试准备和问题生成'
+argument-hint: <职位名称> [--questions <数量>] [--difficulty <级别>]
+---
+
+# AI 面试助手
+
+> **核心理念**: 帮助你准备面试，生成针对性问题和模拟面试场景
+
+## 使用方法
+
+```bash
+/interview <职位名称> [选项]
+```
+
+### 选项说明
+
+| 选项 | 说明 |
+|------|------|
+| `--questions` | 生成问题数量 (默认: 10) |
+| `--difficulty` | 难度级别 (junior/mid/senior) |
+| `--focus` | 重点关注领域 (如: algorithm, system-design) |
+
+---
+
+## 面试职位
+
+$ARGUMENTS
+
+---
+
+## 面试流程
+
+### 第一步：职位分析
+
+分析职位要求，识别核心技能点：
+- 技术栈要求
+- 经验要求
+- 行业背景
+
+### 第二步：问题生成
+
+根据职位要求生成面试问题：
+- 基础知识问题
+- 实战经验问题
+- 系统设计问题
+- 行为面试问题
+
+### 第三步：模拟面试
+
+提供面试模拟场景和参考答案：
+- 问题解析
+- 答题要点
+- 示例回答
+- 评分标准
+
+---
+
+## 建议
+
+```
+💡 面试建议：
+- 提前准备 3-5 个项目案例
+- 练习 STAR 方法回答行为问题
+- 准备 2-3 个有深度的问题反问面试官
+- 了解目标公司的技术栈和业务
+```