@nick848/sf-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sf-cli-team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# sf-cli (spfe)
+
+> 专为前端开发设计的AI驱动CLI工具，支持BDD+TDD+OpenSpec规范
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 特性
+
+- 🤖 **AI驱动** - 支持 GLM-5、GPT-4o、Claude 等多种AI模型
+- 📋 **标准化流程** - BDD+TDD+OpenSpec 规范
+- 📚 **规范学习** - 自动从代码和对话中学习开发规范
+- 🔧 **Sub Agent** - 专业化 Agent 协作（前端开发、代码审核、架构师、测试）
+- 🔄 **工作流控制** - 三阶段人工确认、回滚机制
+- 🔌 **MCP集成** - 支持蓝湖、Figma 设计稿
+
+## 安装
+
+```bash
+# npm
+npm install -g @nick848/sf-cli
+
+# yarn
+yarn global add @nick848/sf-cli
+
+# pnpm
+pnpm add -g @nick848/sf-cli
+```
+
+## 快速开始
+
+```bash
+# 启动交互模式（两种方式）
+sf-cli
+# 或
+spfe
+```
+
+启动后进入交互模式，直接使用 `/` 调用命令：
+
+```
+# 初始化项目
+/init
+
+# 发起新需求
+/new 实现用户登录功能
+
+# 配置AI模型
+/model
+```
+
+## 命令
+
+### 斜杠命令
+
+| 命令 | 说明 |
+|------|------|
+| `/help` | 显示帮助信息 |
+| `/init` | 初始化项目 |
+| `/model` | 配置AI模型 |
+| `/new` | 创建新需求 |
+| `/clear` | 清空对话历史 |
+| `/exit` | 退出CLI |
+| `/update` | 检查更新 |
+
+### OpenSpec 工作流命令
+
+| 命令 | 说明 |
+|------|------|
+| `/opsx:explore` | 探索需求（复杂流程） |
+| `/opsx:new` | 进入设计阶段 |
+| `/opsx:continue` | 继续开发 |
+| `/opsx:apply` | 应用变更 |
+| `/opsx:archive` | 归档总结 |
+| `/opsx:propose` | 简单需求流程 |
+| `/opsx:status` | 查看工作流状态 |
+| `/opsx:rollback` | 回滚工作流 |
+| `/opsx:confirm` | 确认检查点 |
+
+### Agent 调用
+
+| Agent | 说明 |
+|-------|------|
+| `$frontend-dev` | 前端开发 |
+| `$code-reviewer` | 代码审核 |
+| `$architect` | 架构设计 |
+| `$tester` | 测试用例 |
+
+## 工作流
+
+### 复杂需求流程（复杂度 >= 6）
+
+```
+explore → new → continue → apply → archive
+   ↓        ↓                    ↓
+ 确认点   确认点               确认点
+```
+
+### 简单需求流程（复杂度 < 6）
+
+```
+propose → apply → archive
+                 ↓
+              确认点
+```
+
+## 项目结构
+
+```
+.sf-cli/
+├── config.json      # 配置文件
+├── norms/           # 规范学习
+│   ├── patterns.json
+│   ├── weights.json
+│   └── devstanded.md
+└── tokens/          # Token统计
+
+openspec/
+├── config.yaml      # 项目配置
+├── changes/         # 变更记录
+├── spec/            # 归档规范
+└── archive/         # 已归档变更
+```
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `LANHU_TOKEN` | 蓝湖访问令牌 |
+| `FIGMA_ACCESS_TOKEN` | Figma访问令牌 |
+
+## 作为库使用
+
+```typescript
+import { WorkflowEngine, NormsManager, runAgent } from '@nick848/sf-cli';
+
+// 启动工作流
+const engine = new WorkflowEngine();
+await engine.initialize(projectPath);
+await engine.start('实现登录功能', 7);
+
+// 学习规范
+const norms = new NormsManager({ projectPath, normsDir });
+await norms.scanProject(projectPath);
+
+// 调用 Agent
+const result = await runAgent('frontend-dev', ['创建登录组件'], ctx);
+```
+
+## License
+
+[MIT](LICENSE)