ccjk 1.3.2 → 1.3.4

package/templates/claude-code/zh-CN/workflow/essential/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/claude-code/zh-CN/workflow/essential/commands/feat.md

@@ -0,0 +1,105 @@
+---
+description: '用于新增功能开发的命令，支持完整的开发流程和工具集成'
+---
+
+$ARGUMENTS
+
+## 核心工作流程
+
+### 1. 输入分析与类型判断
+
+每次收到用户输入时，首先进行类型判断并明确告知用户：
+
+**判断标准：**
+
+- **需求规划类型**: 用户提出新功能需求、项目构想或需要制定计划
+
+- **讨论迭代类型**: 用户要求继续讨论、修改或完善已有规划
+
+- **执行实施类型**: 用户确认规划完成，要求开始具体实施工作
+
+### 2. 分类处理机制
+
+#### A. 需求规划处理
+
+**触发条件**: 识别为功能需求输入
+
+**执行动作**:
+
+- 启用 Planner Agent
+
+- 生成详细的 markdown 规划文档
+
+- 将文档存储至 `./.claude/plan` 目录，并以 plan/xxx.md 的格式命名
+
+- 包含：目标定义、功能分解、实施步骤、验收标准
+
+#### B. 讨论迭代处理
+
+**触发条件**: 用户要求继续讨论或修改规划
+
+**执行动作**:
+
+- 检索并分析上次生成的规划文件
+
+- 识别用户反馈和确认内容
+
+- 启用 Planner Agent
+
+- 生成详细的 markdown 规划文档
+
+- 建立一个新的文档，比如上一次是 plan/xxx.md，那么这次就是 plan/xxx-1.md，如果上一次是 plan/xxx-1.md，那么这次就是 plan/xxx-2.md，以此类推
+
+- 重新组织待实施任务优先级
+
+#### C. 执行实施处理
+
+**触发条件**: 用户确认规划完成，要求开始执行
+
+**执行动作**:
+
+- 按规划文档顺序启动任务执行
+
+- 每个子任务开始前进行任务类型识别
+
+- **前端任务特殊处理**:
+
+- 检查是否存在可用 UI 设计
+
+- 如无设计方案，must use UI-UX-Designer Agent
+
+- 完成 UI 设计后再进行开发实施
+
+### 3. 关键执行原则
+
+#### 强制响应要求
+
+- **每次交互必须首先说明**: "我判断此次操作类型为：[具体类型]"
+
+- 类型判断必须准确且明确传达给用户
+
+#### 任务执行规范
+
+- 严格按照文档化规划执行
+
+- 子任务启动前必须明确任务性质和依赖关系
+
+- 前端任务必须确保 UI 设计完整性
+
+#### 状态管理机制
+
+- 维护任务完成状态跟踪
+
+- 及时更新规划文档状态
+
+- 确保用户对进度的可见性
+
+## 质量保证要点
+
+1. **类型判断准确性**: 每次交互开始的类型识别必须准确
+
+2. **文档一致性**: 规划文档与实际执行保持同步
+
+3. **依赖关系管理**: 特别关注前端任务的 UI 设计依赖
+
+4. **用户沟通透明**: 所有判断和动作都要明确告知用户

package/templates/claude-code/zh-CN/workflow/essential/commands/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"）。