@jahanxu/code-flow 0.1.0 → 0.2.0

package/src/adapters/claude/commands/cf-validate.md

@@ -0,0 +1,71 @@
+# cf-validate
+
+根据变更文件自动匹配并执行验证规则（测试、类型检查、lint），失败时自动尝试修复。
+
+## 输入
+
+- `/project:cf-validate` — 基于 git diff 自动获取变更文件
+- `/project:cf-validate src/Foo.tsx` — 验证指定文件
+- `/project:cf-validate --files=src/a.ts,src/b.ts` — 验证多个文件
+
+## 执行步骤
+
+### 1. 获取变更文件列表
+
+用 Bash 执行：
+
+```bash
+git diff --name-only HEAD
+```
+
+如果用户指定了文件路径，使用用户指定的文件。如果无变更文件，输出"无变更需要验证"。
+
+### 2. 读取验证规则
+
+用 Read 读取 `.code-flow/validation.yml`。如果不存在，尝试读取 `package.json` 中的 `scripts.test` 和 `scripts.lint` 作为回退。
+
+validation.yml 格式：
+
+```yaml
+validators:
+  - name: "验证器名称"
+    trigger: "**/*.{ts,tsx}"
+    command: "npx tsc --noEmit"
+    timeout: 30000
+    on_fail: "修复建议"
+```
+
+### 3. 匹配并执行验证
+
+对每条验证规则：
+- 将 `trigger` glob 与变更文件列表做匹配
+- 匹配到 → 用 Bash 执行 `command`（将 `{files}` 替换为匹配到的文件路径，**每个路径用单引号包裹防止注入**）
+- 未匹配 → 跳过该规则
+
+每条命令使用对应的 `timeout` 值（毫秒）。
+
+### 4. 汇总结果
+
+- **全部通过** → 输出确认信息
+- **有失败** → 展示每个失败项的：
+  - 验证器名称
+  - 执行的命令
+  - 错误输出（截取关键部分）
+  - `on_fail` 修复建议
+
+### 5. 自动修复
+
+对于失败的验证项，根据错误输出分析问题根因，自动尝试修复代码。修复后提示用户再次运行 `/project:cf-validate` 确认。
+
+## 安全设计
+
+- 对 `{files}` 中的每个文件路径用单引号包裹，防止 shell 注入
+- 仅接受 `git diff` 输出的文件路径或用户显式指定的路径
+- 用户指定的路径必须位于项目根目录内
+
+## 异常处理
+
+- validation.yml 不存在 → 尝试检测 package.json scripts 中的 test/lint 命令
+- 命令执行超时 → 输出超时提示，建议增大 timeout 或缩小验证范围
+- 命令不存在 → 提示安装依赖（如 `pip install mypy`）
+- 无变更文件 → 输出"无变更需要验证"

package/src/cli.js

@@ -66,21 +66,18 @@ function runInit() {
   const adaptersDir = path.join(baseDir, 'adapters');
 
   copyDirRecursive(path.join(coreDir, 'code-flow'), path.join(cwd, '.code-flow'));
-  copyFileIfMissing(path.join(coreDir, 'claude.md'), path.join(cwd, 'CLAUDE.md'));
+  copyFileIfMissing(path.join(adaptersDir, 'claude', 'CLAUDE.md'), path.join(cwd, 'CLAUDE.md'));
   copyDirRecursive(path.join(adaptersDir, 'claude'), path.join(cwd, '.claude'));
 
-  const result = spawnSync(
-    'python3',
-    ['.code-flow/scripts/cf_init.py'],
-    { stdio: 'inherit', cwd }
-  );
-
-  if (result.error) {
-    process.stderr.write(`Error: ${result.error.message}\n`);
-    process.exit(1);
+  // Clean up legacy .claude/skills/ if it exists
+  const legacySkills = path.join(cwd, '.claude', 'skills');
+  if (fs.existsSync(legacySkills)) {
+    fs.rmSync(legacySkills, { recursive: true });
   }
 
-  process.exit(result.status ?? 0);
+  process.stdout.write('code-flow initialized.\n');
+  process.stdout.write('Run /project:cf-init in Claude Code to complete setup.\n');
+  process.exit(0);
 }
 
 const args = process.argv.slice(2);

package/src/adapters/claude/skills/cf-init.md

@@ -1,13 +0,0 @@
-# cf-init
-
-初始化 code-flow 规范体系（目录、配置、spec、skill、hooks）。
-
-## Usage
-- `/cf-init`
-- `/cf-init frontend|backend|fullstack`
-
-## Command
-- `python3 .code-flow/scripts/cf_init.py [frontend|backend|fullstack]`
-
-## Notes
-- 依赖 Python 3.9+ 与 pyyaml（脚本会尝试自动安装）。

package/src/adapters/claude/skills/cf-inject.md

@@ -1,12 +0,0 @@
-# cf-inject
-
-手动注入指定领域或文件路径对应的规范（Hook 失败时回退）。
-
-## Usage
-- `/cf-inject frontend|backend`
-- `/cf-inject path/to/file.ext`
-- `/cf-inject --list-specs --domain=frontend`
-
-## Command
-- `python3 .code-flow/scripts/cf_inject.py [domain|file_path]`
-- `python3 .code-flow/scripts/cf_inject.py --list-specs --domain=frontend`

package/src/adapters/claude/skills/cf-learn.md

@@ -1,11 +0,0 @@
-# cf-learn
-
-将经验沉淀到对应规范的 Learnings 段落。
-
-## Usage
-- `/cf-learn --scope=global --content="..." `
-- `/cf-learn --scope=frontend --content="..." --file=frontend/component-specs.md`
-- `/cf-learn --scope=backend --content="..." --file=backend/logging.md`
-
-## Command
-- `python3 .code-flow/scripts/cf_learn.py --scope=global|frontend|backend --content=\"...\" [--file=spec] [--dry-run]`

package/src/adapters/claude/skills/cf-scan.md

@@ -1,12 +0,0 @@
-# cf-scan
-
-审计规范文件的 token 分布与问题提示。
-
-## Usage
-- `/cf-scan`
-- `/cf-scan --json`
-- `/cf-scan --only-issues`
-- `/cf-scan --limit=10`
-
-## Command
-- `python3 .code-flow/scripts/cf_scan.py [--json] [--only-issues] [--limit=N]`

package/src/adapters/claude/skills/cf-stats.md

@@ -1,11 +0,0 @@
-# cf-stats
-
-统计 L0/L1 规范 token 使用情况。
-
-## Usage
-- `/cf-stats`
-- `/cf-stats --human`
-- `/cf-stats --domain=frontend`
-
-## Command
-- `python3 .code-flow/scripts/cf_stats.py [--human] [--domain=frontend]`

package/src/adapters/claude/skills/cf-validate.md

@@ -1,12 +0,0 @@
-# cf-validate
-
-基于变更文件执行验证规则（类型检查/测试/lint）。
-
-## Usage
-- `/cf-validate`
-- `/cf-validate path/to/file.py`
-- `/cf-validate --files=src/a.ts,src/b.ts`
-- `/cf-validate --only-failed`
-
-## Command
-- `python3 .code-flow/scripts/cf_validate.py [file_path] [--files=...] [--only-failed] [--json-short] [--output=table]`