cangming-ai-dev-kit 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3b9d632f3320840062e4a01c6778af96b76636de64ef3596e70fa571bec73f62
+  data.tar.gz: b697979c35319751a6546320ec79bc07f9319b92ab21c3888828dbb7f5040929
+SHA512:
+  metadata.gz: 90672dac17b785772912c7f7fe173a1246e5cdb7ace22f979daa404e7244a57b7f31d611807e43dc7d65e172ba04fdc7391d1d21d0c7df0f5ef752c4a7658838
+  data.tar.gz: 2484751a06514442ab62ff30a20692354379286dc0efa8609eef1d4cb00e005dae25d584ed795a40aab44c9ba5e576a32aee4004432aab5af77d815b82975731

data/adapters/claude-code/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "cangming-dev-core",
+  "version": "0.1.0",
+  "description": "cangming-ai-dev-kit Claude Code 插件 — 通用开发能力 + HarmonyOS 领域知识",
+  "source": "..",
+  "skills": {
+    "core/plan-first": "skills/core/plan-first/SKILL.md",
+    "core/safe-code-change": "skills/core/safe-code-change/SKILL.md",
+    "core/code-review": "skills/core/code-review/SKILL.md",
+    "core/verify-before-done": "skills/core/verify-before-done/SKILL.md",
+    "harmony/harmony-plan": "skills/harmony/harmony-plan/SKILL.md",
+    "harmony/harmony-code": "skills/harmony/harmony-code/SKILL.md",
+    "harmony/harmony-verify": "skills/harmony/harmony-verify/SKILL.md"
+  },
+  "agents": {
+    "planner": "agents/planner.md",
+    "coder": "agents/coder.md",
+    "reviewer": "agents/reviewer.md"
+  }
+}

data/adapters/claude-code/agents/coder.md

@@ -0,0 +1,22 @@
+# Coder Agent
+
+## 职责
+按计划小步实现代码。
+
+## 工作流程
+1. 确认计划已批准
+2. 按顺序逐个文件实现
+3. 每次修改后检查 diff
+4. 运行相关测试
+5. 失败时回滚或说明
+
+## 输入
+- 已批准的计划文档
+- 当前项目代码
+
+## 约束
+遵循 `core/skills/safe-code-change/SKILL.md` 的规则：
+- 小步修改
+- 不引入无关依赖
+- 不破坏现有 API
+- 保持项目风格

data/adapters/claude-code/agents/planner.md

@@ -0,0 +1,24 @@
+# Planner Agent
+
+## 职责
+只做计划，不写代码。
+
+## 工作流程
+1. 读取需求
+2. 扫描项目结构
+3. 识别风险
+4. 制定文件改动计划
+5. 制定测试计划
+6. 输出计划文档
+
+## 输入
+- 任务需求描述
+- 项目目录结构
+
+## 输出
+遵循 `core/skills/plan-first/SKILL.md` 的输出格式。
+
+## 限制
+- 不修改任何文件
+- 不生成代码
+- 如果计划需要修改超过 5 个文件，提出简化和合并建议

data/adapters/claude-code/agents/reviewer.md

@@ -0,0 +1,23 @@
+# Reviewer Agent
+
+## 职责
+审查代码质量和验收。
+
+## 工作流程
+1. 读取改动 diff
+2. 运行 core/skills/code-review/SKILL.md 的完整审查清单
+3. 输出审查报告
+4. 运行 core/skills/verify-before-done/SKILL.md 的验证流程
+5. 输出验证报告
+
+## 输入
+- 代码改动 diff
+- 项目验证脚本
+
+## 输出
+- 审查报告（问题列表 + 结论）
+- 验证报告（命令 + 结果）
+
+## 约束
+- 不修改代码
+- 发现 error 级别问题必须阻止完成

data/adapters/claude-code/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "description": "cangming-ai-dev-kit Claude Code hooks — MVP 示例",
+  "notice": "这是一个 MVP 示例。实际使用时请按当前 Claude Code hooks 文档调整 schema。",
+  "hooks": [
+    {
+      "name": "pre-commit",
+      "description": "提交前运行 verify 脚本",
+      "command": "bash scripts/verify_mvp.sh"
+    },
+    {
+      "name": "pre-exit",
+      "description": "任务结束前验证项目",
+      "command": "bash core/scripts/verify_project.sh"
+    }
+  ]
+}

data/adapters/codex/.codex-plugin/plugin.json

@@ -0,0 +1,26 @@
+{
+  "name": "cangming-dev-core",
+  "version": "0.1.0",
+  "description": "cangming-ai-dev-kit Codex 插件 — 通用开发能力 + HarmonyOS 领域知识",
+  "source": "..",
+  "skills": {
+    "core/plan-first": "skills/core/plan-first/SKILL.md",
+    "core/safe-code-change": "skills/core/safe-code-change/SKILL.md",
+    "core/code-review": "skills/core/code-review/SKILL.md",
+    "core/verify-before-done": "skills/core/verify-before-done/SKILL.md",
+    "harmony/harmony-plan": "skills/harmony/harmony-plan/SKILL.md",
+    "harmony/harmony-code": "skills/harmony/harmony-code/SKILL.md",
+    "harmony/harmony-verify": "skills/harmony/harmony-verify/SKILL.md"
+  },
+  "agents": {
+    "planner": {
+      "system_prompt": "你是一个只做计划的 agent。不要写代码。阅读项目结构，输出计划文档。遵循 AGENTS.md 规则。"
+    },
+    "coder": {
+      "system_prompt": "你是一个按计划实现代码的 agent。小步修改，每次检查 diff。遵循 AGENTS.md 规则。"
+    },
+    "reviewer": {
+      "system_prompt": "你是一个代码审查 agent。审查代码质量、安全性和测试覆盖。遵循 AGENTS.md 规则。"
+    }
+  }
+}

data/adapters/codex/AGENTS.md.template

@@ -0,0 +1,45 @@
+# AGENTS.md — Codex 项目规则（模板）
+
+将此文件复制到你的 Codex 项目根目录，按需修改。
+
+## 核心规则
+
+1. **先 plan 再 code**：任何超过 5 行的改动，必须先输出计划。
+2. **读项目结构**：修改前阅读 README.md 和关键配置文件。
+3. **运行 verify**：修改后必须运行 `bash core/scripts/verify_project.sh`。
+4. **不伪造结果**：lint/test/build 不通过不能说完成。
+
+## Skills 引用
+
+本项目 skills 位于 `skills/` 目录：
+
+| Skill 文件 | 用途 |
+|------------|------|
+| `skills/core/plan-first/SKILL.md` | 计划制定 |
+| `skills/core/safe-code-change/SKILL.md` | 安全编码 |
+| `skills/core/code-review/SKILL.md` | 代码审查 |
+| `skills/core/verify-before-done/SKILL.md` | 验证流程 |
+| `skills/harmony/harmony-plan/SKILL.md` | HarmonyOS 计划 |
+| `skills/harmony/harmony-code/SKILL.md` | HarmonyOS 编码 |
+| `skills/harmony/harmony-verify/SKILL.md` | HarmonyOS 验证 |
+
+## 验证命令
+
+```bash
+# 通用验证
+bash core/scripts/verify_project.sh
+
+# MVP 自验证
+bash scripts/verify_mvp.sh
+```
+
+## 完成输出格式
+
+```markdown
+## 执行摘要
+- 项目类型：{type}
+- 改动文件：{files}
+- 执行命令：
+  1. {command_1} → {result}
+- 验证结果：{PASS / FAIL}
+```

data/core/references/review_checklist.md

@@ -0,0 +1,48 @@
+# 通用代码审查清单
+
+## 功能正确性
+- [ ] 实现了需求中的所有功能
+- [ ] 边界条件已处理（空值、越界、异常）
+- [ ] 错误路径有合理处理（try-catch、错误返回）
+- [ ] 并发/竞态条件已考虑
+
+## 代码质量
+- [ ] 命名清晰且符合项目规范
+- [ ] 函数/方法职责单一
+- [ ] 无重复代码（DRY）
+- [ ] 无过深的嵌套（不超过 3 层）
+- [ ] 注释只解释 WHY，不解释 WHAT
+
+## 类型安全
+- [ ] 所有变量有类型声明
+- [ ] 无隐含的 any
+- [ ] 泛型使用正确
+- [ ] 无类型断言滥用
+
+## 性能
+- [ ] 无不必要的重复计算
+- [ ] 无内存泄漏风险
+- [ ] 无阻塞主线程操作
+- [ ] 循环/递归有退出条件
+
+## 安全
+- [ ] 无硬编码密钥/密码
+- [ ] 用户输入已校验
+- [ ] 无命令注入风险
+- [ ] 无路径遍历风险
+
+## 测试
+- [ ] 新代码有对应测试
+- [ ] 边界条件有测试覆盖
+- [ ] 测试可独立运行
+- [ ] 测试命名清晰
+
+## 依赖
+- [ ] 未引入不必要的第三方库
+- [ ] 已有依赖版本兼容
+- [ ] 无循环依赖
+
+## 版本控制
+- [ ] 无调试代码/console.log
+- [ ] 无被注释的代码块
+- [ ] 提交信息清晰

data/core/references/verify_rules.md

@@ -0,0 +1,48 @@
+# 验收规则
+
+## 黄金法则
+
+**不能伪造验证结果。**
+
+即使验证看起来"麻烦"或"没必要"，也要执行。如果命令不存在，输出明确说明，不能假装成功。
+
+## 规则清单
+
+### 规则 1：先识别，再验证
+```bash
+bash core/scripts/detect_project_type.sh
+```
+不知道项目类型就无法正确验证。
+
+### 规则 2：使用正确的验证脚本
+
+| 项目类型 | 验证脚本 |
+|----------|----------|
+| harmony | `domains/harmony/scripts/verify_harmony.sh` |
+| flutter | TODO（扩展中） |
+| iOS | TODO（扩展中） |
+| android | TODO（扩展中） |
+| node | TODO（扩展中） |
+| unknown | 提示手动配置 |
+
+### 规则 3：每条命令都要记录
+记录内容包括：
+- 执行的命令
+- 实际输出
+- 结果（PASS / FAIL / SKIP）
+
+### 规则 4：失败必须修复
+- 验证失败 → 修复问题 → 重新验证
+- 不允许说"虽然验证失败但代码是对的"
+- 不允许说"这个失败和我的改动无关"
+
+### 规则 5：全部通过才能完成
+只有当所有 verify 项都是 PASS 时，才能宣布完成。
+如果有 SKIP 项，必须有明确的跳过原因（如命令不存在）。
+
+### 规则 6：MVP 自验证
+对 cangming-ai-dev-kit 自身的修改，必须运行：
+```bash
+bash scripts/verify_mvp.sh
+```
+确保项目结构完整。

data/core/references/workflow.md

@@ -0,0 +1,65 @@
+# 通用开发工作流
+
+## Plan → Code → Review → Verify
+
+每个开发任务严格遵循四个阶段：
+
+### 1. Plan（计划）
+- 理解需求，复述确认
+- 扫描项目结构
+- 识别风险点
+- 制定文件改动计划
+- **输出**：计划文档
+- **验收**：得到确认
+
+### 2. Code（编码）
+- 按计划小步修改
+- 一次改一个逻辑单元
+- 每次修改后检查 diff
+- 运行相关测试
+- **输出**：代码改动
+- **验收**：diff 已审查
+
+### 3. Review（审查）
+- 逐项审查代码质量
+- 检查功能正确性、边界条件、类型安全
+- 检查性能和安全风险
+- 检查测试覆盖
+- **输出**：审查报告
+- **验收**：所有 error 级别问题已修复
+
+### 4. Verify（验证）
+- 识别项目类型
+- 运行对应 verify 脚本
+- 记录命令和结果
+- **输出**：验证报告
+- **验收**：全部 PASS
+
+### 流程图
+
+```
+需求输入
+    │
+    ▼
+┌─────────┐
+│  Plan   │ ◄── 未确认
+└────┬────┘
+     │ 确认
+     ▼
+┌─────────┐
+│  Code   │ ◄── 测试失败
+└────┬────┘
+     │ diff 审查通过
+     ▼
+┌──────────┐
+│  Review  │ ◄── 发现问题
+└────┬─────┘
+     │ 审查通过
+     ▼
+┌──────────┐
+│  Verify  │ ◄── 验证失败
+└────┬─────┘
+     │ 全部 PASS
+     ▼
+   完成
+```

data/core/scripts/detect_project_type.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# detect_project_type.sh — 根据文件判断项目类型
+# 用法: bash core/scripts/detect_project_type.sh [项目目录]
+
+PROJECT_DIR="${1:-.}"
+cd "$PROJECT_DIR" 2>/dev/null || { echo "unknown"; exit 0; }
+
+# HarmonyOS (按优先级: oh-package.json5 > hvigorfile.ts > build-profile.json5)
+if [ -f "oh-package.json5" ] && [ -f "hvigorfile.ts" ] && [ -d "entry/src/main/ets" ]; then
+    echo "harmony"
+    exit 0
+fi
+
+# Flutter
+if [ -f "pubspec.yaml" ]; then
+    echo "flutter"
+    exit 0
+fi
+
+# iOS
+if ls *.xcodeproj 2>/dev/null | head -1 | grep -q .; then
+    echo "ios"
+    exit 0
+fi
+if [ -f "Package.swift" ]; then
+    echo "ios"
+    exit 0
+fi
+
+# Android
+if [ -f "build.gradle" ] || [ -f "settings.gradle" ] || [ -f "build.gradle.kts" ] || [ -f "settings.gradle.kts" ]; then
+    echo "android"
+    exit 0
+fi
+
+# Godot
+if [ -f "project.godot" ]; then
+    echo "godot"
+    exit 0
+fi
+
+# Node
+if [ -f "package.json" ]; then
+    echo "node"
+    exit 0
+fi
+
+# 未知类型
+echo "unknown"

data/core/scripts/summarize_context.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# summarize_context.sh — 输出当前上下文摘要
+# 用法: bash core/scripts/summarize_context.sh [项目目录]
+
+PROJECT_DIR="${1:-.}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "===== 上下文摘要 ====="
+echo ""
+
+# 项目类型
+PROJECT_TYPE=$(bash "$SCRIPT_DIR/detect_project_type.sh" "$PROJECT_DIR")
+echo "项目类型: $PROJECT_TYPE"
+
+# 项目路径
+cd "$PROJECT_DIR" 2>/dev/null
+echo "项目路径: $(pwd)"
+echo ""
+
+# Git 状态
+if git rev-parse --git-dir > /dev/null 2>&1; then
+    echo "--- Git 状态 ---"
+    git status --short 2>/dev/null || echo "  (无未提交改动)"
+
+    BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+    echo "当前分支: $BRANCH"
+
+    LAST_COMMIT=$(git log --oneline -1 2>/dev/null)
+    echo "最近提交: $LAST_COMMIT"
+else
+    echo "--- Git 状态 ---"
+    echo "  (不是 Git 仓库)"
+fi
+echo ""
+
+# 最近改动文件
+echo "--- 最近改动文件 ---"
+if git rev-parse --git-dir > /dev/null 2>&1; then
+    git diff --name-only 2>/dev/null | head -20
+    git diff --cached --name-only 2>/dev/null | head -20
+else
+    find . -type f -name "*.ts" -o -name "*.sh" -o -name "*.json" -o -name "*.md" 2>/dev/null | head -20
+fi
+echo ""
+
+# 关键文件
+echo "--- 关键文件 ---"
+for f in package.json oh-package.json5 hvigorfile.ts pubspec.yaml build.gradle settings.gradle; do
+    if [ -f "$f" ]; then
+        echo "  $f (存在)"
+    fi
+done
+
+echo ""
+echo "===== 结束 ====="

data/core/scripts/verify_project.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+# verify_project.sh — 根据项目类型执行对应验证
+# 用法: bash core/scripts/verify_project.sh [项目目录]
+
+PROJECT_DIR="${1:-.}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_TYPE=$(bash "$SCRIPT_DIR/detect_project_type.sh" "$PROJECT_DIR")
+
+echo "===== 项目验证 ====="
+echo "项目目录: $(cd "$PROJECT_DIR" && pwd)"
+echo "项目类型: $PROJECT_TYPE"
+echo ""
+
+case "$PROJECT_TYPE" in
+    harmony)
+        echo "检测到 HarmonyOS 项目，执行 HarmonyOS 验证..."
+        HARMONY_SCRIPT="$SCRIPT_DIR/../../domains/harmony/scripts/verify_harmony.sh"
+        if [ -f "$HARMONY_SCRIPT" ]; then
+            bash "$HARMONY_SCRIPT" "$PROJECT_DIR"
+        else
+            echo "WARN: 未找到 $HARMONY_SCRIPT"
+            exit 0
+        fi
+        ;;
+    flutter)
+        echo "TODO: Flutter 验证脚本尚未实现"
+        echo "项目类型: flutter"
+        exit 0
+        ;;
+    ios)
+        echo "TODO: iOS 验证脚本尚未实现"
+        echo "项目类型: ios"
+        exit 0
+        ;;
+    android)
+        echo "TODO: Android 验证脚本尚未实现"
+        echo "项目类型: android"
+        exit 0
+        ;;
+    godot)
+        echo "TODO: Godot 验证脚本尚未实现"
+        echo "项目类型: godot"
+        exit 0
+        ;;
+    node)
+        echo "TODO: Node 验证脚本尚未实现"
+        echo "项目类型: node"
+        exit 0
+        ;;
+    unknown)
+        echo "未知项目类型，请手动配置验证脚本"
+        echo "支持的检测条件:"
+        echo "  - HarmonyOS: oh-package.json5 + hvigorfile.ts + entry/src/main/ets"
+        echo "  - Flutter:   pubspec.yaml"
+        echo "  - iOS:       *.xcodeproj 或 Package.swift"
+        echo "  - Android:   build.gradle 或 settings.gradle"
+        echo "  - Godot:     project.godot"
+        echo "  - Node:      package.json"
+        exit 0
+        ;;
+esac

data/core/skills/code-review/SKILL.md

@@ -0,0 +1,71 @@
+# code-review — 代码审查
+
+## description
+对代码改动进行全面审查，确保功能正确性、代码质量和安全性。
+
+## when to use
+- 任何代码修改之后
+- 提交 PR 之前
+- 合并到主分支之前
+
+## workflow
+1. 读取 diff 或改动文件
+2. 逐项检查清单
+3. 记录发现的问题
+4. 输出审查报告
+
+## 检查清单
+
+### 功能正确性
+- [ ] 代码实现了需求中的所有功能点
+- [ ] 边界条件已处理（空值、越界、异常输入）
+- [ ] 错误路径有合理的处理逻辑
+
+### 类型安全
+- [ ] 所有变量有正确的类型声明
+- [ ] 无隐含的 any 类型
+- [ ] 泛型使用正确
+
+### 性能风险
+- [ ] 无不必要的重复计算
+- [ ] 无内存泄漏风险
+- [ ] 无阻塞主线程的操作
+
+### 安全风险
+- [ ] 无硬编码敏感信息
+- [ ] 输入已校验/清理
+- [ ] 无命令注入风险
+
+### 测试覆盖
+- [ ] 新代码有对应测试
+- [ ] 边界条件有测试覆盖
+- [ ] 测试命名清晰
+
+### 项目规则
+- [ ] 符合项目代码风格
+- [ ] 无未使用的 import/变量
+- [ ] 命名符合项目规范
+
+## output format
+
+```markdown
+## 审查报告：{文件/PR 名称}
+
+### 发现的问题
+| 级别 | 文件 | 行号 | 说明 |
+|------|------|------|------|
+| error | src/x.ts | 42 | {问题描述} |
+| warn  | src/y.ts | 15 | {问题描述} |
+
+### 建议
+- {建议 1}
+- {建议 2}
+
+### 结论
+{PASS / 需修改后重新审查}
+```
+
+## done criteria
+- [ ] 所有 error 级别问题已修复
+- [ ] 所有 warn 级别问题已评估
+- [ ] 审查报告已输出

data/core/skills/plan-first/SKILL.md

@@ -0,0 +1,56 @@
+# plan-first — 先计划再实施
+
+## description
+在任何代码修改前制定完整计划，确保方向正确、风险可控。
+
+## when to use
+- 任何超过 10 行的改动
+- 涉及多个文件的改动
+- 不熟悉当前项目结构时
+- HarmonyOS / Flutter / 跨平台项目
+
+## workflow
+1. 读取需求并复述理解
+2. 扫描项目目录结构
+3. 识别风险点
+4. 制定文件改动计划
+5. 制定测试计划
+6. 输出正式计划文档
+7. 获得确认后开始编码
+
+## output format
+
+```markdown
+## 计划：{任务名称}
+
+### 需求理解
+{用一两句话复述需求}
+
+### 当前项目结构观察
+{关键目录和文件摘要}
+
+### 风险点
+- {风险 1}
+- {风险 2}
+
+### 文件改动计划
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| src/xxx.ts | 修改 | {修改内容} |
+| src/yyy.ts | 新增 | {新增内容} |
+
+### 测试计划
+- {测试 1}
+- {测试 2}
+
+### 验收命令
+```bash
+{命令 1}
+{命令 2}
+```
+
+### 停止条件
+- [ ] 计划未被确认 → 不改代码
+- [ ] 发现新风险 → 更新计划
+- [ ] 验收命令未通过 → 不完成
+```