@jahanxu/code-flow 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,88 @@
+# code-flow
+
+一个用于快速初始化与管理项目规范的命令行工具。通过全局安装后执行 `code-flow init`，自动生成项目约定文件与目录结构，帮助团队统一流程并提升协作效率。
+
+## 安装
+
+npm：
+
+```bash
+npm i -g @jahanxu/code-flow
+```
+
+pnpm：
+
+```bash
+pnpm add -g @jahanxu/code-flow
+```
+
+## 升级
+
+npm：
+
+```bash
+npm i -g @jahanxu/code-flow@latest
+```
+
+pnpm：
+
+```bash
+pnpm add -g @jahanxu/code-flow@latest
+```
+
+## 卸载
+
+npm：
+
+```bash
+npm rm -g @jahanxu/code-flow
+```
+
+pnpm：
+
+```bash
+pnpm remove -g @jahanxu/code-flow
+```
+
+## 基本用法
+
+初始化：
+
+```bash
+code-flow init
+```
+
+查看帮助：
+
+```bash
+code-flow --help
+```
+
+## 生成的目录与文件
+
+运行 `code-flow init` 后，将在项目根目录生成（或更新）以下结构：
+
+```
+.code-flow/
+.claude/
+CLAUDE.md
+```
+
+## 依赖说明
+
+- 需要 `python3` 版本 3.9 及以上
+- 需要安装 `pyyaml`（`cf_init` 会尝试自动安装，失败会提示手动处理）
+
+## 常见问题
+
+- EOTP（`--otp`）
+  - 原因：启用了 npm/pnpm 的一次性密码或 2FA。
+  - 处理：按提示输入 OTP，或使用 `--otp` 重新执行安装命令。
+
+- E402（`--access=public`）
+  - 原因：发布/安装时访问级别不匹配或权限不足。
+  - 处理：必要时使用 `--access=public` 重新发布或检查权限配置。
+
+- name 冲突
+  - 原因：本地或全局已有同名命令/包。
+  - 处理：先卸载冲突包或更换名称后再安装。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jahanxu/code-flow",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "UNLICENSED",
   "bin": {
     "code-flow": "src/cli.js"

package/src/adapters/claude/CLAUDE.md

@@ -0,0 +1,23 @@
+# Project Guidelines
+
+## Team Identity
+- Team: [team name]
+- Project: [project name]
+- Language: [primary language]
+
+## Core Principles
+- All changes must include tests
+- Single responsibility per function (<= 50 lines)
+- No loose typing or silent exception handling
+- Handle errors explicitly
+
+## Forbidden Patterns
+- Hard-coded secrets or credentials
+- Unparameterized SQL
+- Network calls inside tight loops
+
+## Spec Loading
+This project uses the code-flow layered spec system.
+Specs live in .code-flow/specs/ and are injected on demand.
+
+## Learnings

package/src/cli.js

@@ -66,7 +66,7 @@ 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(