ccjk 1.3.3 → 1.3.4

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"）。