cognitive-modules 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

cognitive/registry.py

@@ -31,7 +31,7 @@ SEARCH_PATHS = [
 USER_MODULES_DIR = Path.home() / ".cognitive" / "modules"
 
 # Default registry URL
-DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/leizii/cognitive-modules/main/cognitive-registry.json"
+DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/ziel-io/cognitive-modules/main/cognitive-registry.json"
 
 # Local registry cache
 REGISTRY_CACHE = Path.home() / ".cognitive" / "registry-cache.json"

cognitive_modules-0.1.1.dist-info/METADATA

@@ -0,0 +1,289 @@
+Metadata-Version: 2.4
+Name: cognitive-modules
+Version: 0.1.1
+Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
+Author: ziel-io
+License: MIT
+Project-URL: Homepage, https://github.com/ziel-io/cognitive-modules
+Project-URL: Documentation, https://github.com/ziel-io/cognitive-modules#readme
+Project-URL: Repository, https://github.com/ziel-io/cognitive-modules
+Project-URL: Issues, https://github.com/ziel-io/cognitive-modules/issues
+Keywords: llm,cognitive,modules,ai,cli,schema,validation,prompt,agent,subagent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema>=4.17.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: ollama
+Requires-Dist: requests>=2.28.0; extra == "ollama"
+Provides-Extra: minimax
+Requires-Dist: openai>=1.0.0; extra == "minimax"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Requires-Dist: requests>=2.28.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
+Dynamic: license-file
+
+# Cognitive Modules
+
+[![CI](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml/badge.svg)](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/cognitive-modules.svg)](https://pypi.org/project/cognitive-modules/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> 可验证的结构化 AI 任务规范
+
+Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、可验证、可审计**的生成任务设计。
+
+## 特性
+
+- **强类型契约** - JSON Schema 双向验证输入输出
+- **可解释输出** - 强制输出 `confidence` + `rationale`
+- **子代理编排** - `@call:module` 支持模块间调用
+- **参数传递** - `$ARGUMENTS` 运行时替换
+- **多 LLM 支持** - OpenAI / Anthropic / MiniMax / Ollama
+- **公共注册表** - `cog install registry:module-name`
+
+## 安装
+
+```bash
+# 基础安装
+pip install cognitive-modules
+
+# 带 LLM 支持
+pip install cognitive-modules[openai]      # OpenAI
+pip install cognitive-modules[anthropic]   # Claude
+pip install cognitive-modules[all]         # 全部
+```
+
+## 快速开始
+
+```bash
+# 配置 LLM
+export LLM_PROVIDER=openai
+export OPENAI_API_KEY=sk-xxx
+
+# 或使用 MiniMax
+export LLM_PROVIDER=minimax
+export MINIMAX_API_KEY=sk-xxx
+
+# 运行代码审查
+cog run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
+
+# 运行任务排序
+cog run task-prioritizer --args "修复bug(紧急), 写文档, 优化性能" --pretty
+
+# 运行 API 设计
+cog run api-designer --args "用户系统 CRUD API" --pretty
+```
+
+## 与 Skills 对比
+
+| | Skills | Cognitive Modules |
+|---|--------|------------------|
+| 定位 | 轻量指令扩展 | 可验证的结构化任务 |
+| 输入校验 | ❌ | ✅ JSON Schema |
+| 输出校验 | ❌ | ✅ JSON Schema |
+| 置信度 | ❌ | ✅ 必须 0-1 |
+| 推理过程 | ❌ | ✅ 必须 rationale |
+| 参数传递 | ✅ $ARGUMENTS | ✅ $ARGUMENTS |
+| 子代理 | ✅ context: fork | ✅ @call + context |
+| 验证工具 | ❌ | ✅ cog validate |
+| 注册表 | ❌ | ✅ cog install |
+
+## CLI 命令
+
+```bash
+# 模块管理
+cog list                    # 列出已安装模块
+cog info <module>           # 查看模块详情
+cog validate <module>       # 验证模块结构
+
+# 运行模块
+cog run <module> input.json -o output.json --pretty
+cog run <module> --args "需求描述" --pretty
+cog run <module> --args "需求" --subagent  # 启用子代理
+
+# 创建模块
+cog init <name> -d "描述"
+
+# 安装/卸载
+cog install github:user/repo/path
+cog install registry:module-name
+cog uninstall <module>
+
+# 注册表
+cog registry                # 查看公共模块
+cog search <query>          # 搜索模块
+
+# 环境检查
+cog doctor
+```
+
+## 内置模块
+
+| 模块 | 功能 | 示例 |
+|------|------|------|
+| `code-reviewer` | 代码审查 | `cog run code-reviewer --args "你的代码"` |
+| `task-prioritizer` | 任务优先级排序 | `cog run task-prioritizer --args "任务1,任务2"` |
+| `api-designer` | REST API 设计 | `cog run api-designer --args "订单系统"` |
+| `ui-spec-generator` | UI 规范生成 | `cog run ui-spec-generator --args "电商首页"` |
+| `product-analyzer` | 产品分析（子代理示例） | `cog run product-analyzer --args "健康产品" -s` |
+
+## 模块格式
+
+### 新格式（推荐）
+
+```
+my-module/
+├── MODULE.md       # 元数据 + 指令
+├── schema.json     # 输入输出 Schema
+└── examples/
+    ├── input.json
+    └── output.json
+```
+
+### MODULE.md
+
+```yaml
+---
+name: my-module
+version: 1.0.0
+responsibility: 一句话描述
+
+excludes:
+  - 不做的事情
+
+constraints:
+  no_network: true
+  no_inventing_data: true
+  require_confidence: true
+  require_rationale: true
+
+context: fork  # 可选：隔离执行
+---
+
+# 指令
+
+根据用户需求 $ARGUMENTS 执行任务。
+
+可以调用其他模块：
+@call:other-module($ARGUMENTS)
+```
+
+## 在 AI 工具中使用
+
+### Cursor / Codex CLI
+
+在项目根目录创建 `AGENTS.md`：
+
+```markdown
+## 代码审查
+
+当需要审查代码时：
+1. 读取 `~/.cognitive/modules/code-reviewer/MODULE.md`
+2. 按 schema.json 格式输出
+3. 包含 issues、summary、rationale、confidence
+```
+
+### 直接对话
+
+```
+读取 ~/.cognitive/modules/code-reviewer/MODULE.md，
+审查这段代码：def login(u,p): ...
+```
+
+## 配置 LLM
+
+```bash
+# OpenAI
+export LLM_PROVIDER=openai
+export OPENAI_API_KEY=sk-xxx
+
+# Anthropic Claude
+export LLM_PROVIDER=anthropic
+export ANTHROPIC_API_KEY=sk-ant-xxx
+
+# MiniMax
+export LLM_PROVIDER=minimax
+export MINIMAX_API_KEY=sk-xxx
+
+# Ollama（本地）
+export LLM_PROVIDER=ollama
+
+# 检查配置
+cog doctor
+```
+
+## 开发
+
+```bash
+# 克隆
+git clone https://github.com/ziel-io/cognitive-modules.git
+cd cognitive-modules
+
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest tests/ -v
+
+# 创建新模块
+cog init my-module -d "模块描述"
+cog validate my-module
+```
+
+## 项目结构
+
+```
+cognitive-modules/
+├── src/cognitive/          # CLI 源码
+│   ├── cli.py              # 命令入口
+│   ├── loader.py           # 模块加载
+│   ├── runner.py           # 模块执行
+│   ├── subagent.py         # 子代理编排
+│   ├── validator.py        # 模块验证
+│   ├── registry.py         # 模块安装
+│   ├── templates.py        # 模块模板
+│   └── providers/          # LLM 后端
+├── cognitive/modules/      # 内置模块
+├── tests/                  # 单元测试
+├── SPEC.md                 # 规范文档
+├── INTEGRATION.md          # 集成指南
+└── cognitive-registry.json # 公共注册表
+```
+
+## 文档
+
+- [SPEC.md](SPEC.md) - 完整规范（含上下文哲学）
+- [INTEGRATION.md](INTEGRATION.md) - Agent 工具集成指南
+
+## License
+
+MIT

{cognitive_modules-0.1.0.dist-info → cognitive_modules-0.1.1.dist-info}/RECORD

@@ -1,15 +1,15 @@
 cognitive/__init__.py,sha256=uSX5NuOWyW0qtq1bnxbzabZ0OQakAtsjF0MWbjQBvwE,401
 cognitive/cli.py,sha256=q0vHCHFmig9gQ85KRyIrX6vrJZFm5nXF_bW5qQRGEPU,14608
 cognitive/loader.py,sha256=E_lSuy2ERBWfziOHr3f13nLq-wEYvBqIKrGlPk4PQyA,4031
-cognitive/registry.py,sha256=Adb9246LH5mj6aObpZs-QkqdB3iC7f9-3C0kItgfvrI,8850
+cognitive/registry.py,sha256=aBkkpg5PtL_tKDIOXpv6vblB7x_Ax0eVaWgejuQTfCE,8851
 cognitive/runner.py,sha256=9uxBAGd3gtXnwUm5x2CjhXi_S1gd2nfjRfM3Q_1f30Q,4362
 cognitive/subagent.py,sha256=fb7LWwNF6YcJtC_T1dK0EvzqWMBnav-kiCIpvVohEBw,8142
 cognitive/templates.py,sha256=fEd1Tj5A12PUE256dC7-cnsulWzm6MTrcQ0yLPWrtx0,4692
 cognitive/validator.py,sha256=1v1HUHYOlAc2sYCkIq_gnUMMnca0fdtQwr7UMBFpp04,12200
 cognitive/providers/__init__.py,sha256=hqhVA1IEXpVtyCAteXhO5yD8a8ikQpVIPEKJVHLtRFY,7492
-cognitive_modules-0.1.0.dist-info/licenses/LICENSE,sha256=f7MIeafHCzp_CW2Oq1aAjmZjFUa3hBILmBEMl7AsK7k,1063
-cognitive_modules-0.1.0.dist-info/METADATA,sha256=wS_z7RLTFaawk0XDoqiRNoibRrfM6UH9hxRliNcUm28,7530
-cognitive_modules-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cognitive_modules-0.1.0.dist-info/entry_points.txt,sha256=PKHlfrFmve5K2349ryipySKbOOsKxo_vIq1NNT-iBV0,42
-cognitive_modules-0.1.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
-cognitive_modules-0.1.0.dist-info/RECORD,,
+cognitive_modules-0.1.1.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
+cognitive_modules-0.1.1.dist-info/METADATA,sha256=oonLUUD0fO3t7bo8DVZKlqC1vM5ZyHFUw7KXP46SLdI,8242
+cognitive_modules-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cognitive_modules-0.1.1.dist-info/entry_points.txt,sha256=PKHlfrFmve5K2349ryipySKbOOsKxo_vIq1NNT-iBV0,42
+cognitive_modules-0.1.1.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
+cognitive_modules-0.1.1.dist-info/RECORD,,

{cognitive_modules-0.1.0.dist-info → cognitive_modules-0.1.1.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 leizii
+Copyright (c) 2026 ziel-io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

cognitive_modules-0.1.0.dist-info/METADATA

@@ -1,295 +0,0 @@
-Metadata-Version: 2.4
-Name: cognitive-modules
-Version: 0.1.0
-Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
-Author: leizii
-License: MIT
-Project-URL: Homepage, https://github.com/leizii/cognitive-modules
-Project-URL: Documentation, https://github.com/leizii/cognitive-modules#readme
-Project-URL: Repository, https://github.com/leizii/cognitive-modules
-Project-URL: Issues, https://github.com/leizii/cognitive-modules/issues
-Keywords: llm,cognitive,modules,ai,cli,schema,validation,prompt,agent,subagent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: jsonschema>=4.17.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: rich>=13.0.0
-Provides-Extra: openai
-Requires-Dist: openai>=1.0.0; extra == "openai"
-Provides-Extra: anthropic
-Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
-Provides-Extra: ollama
-Requires-Dist: requests>=2.28.0; extra == "ollama"
-Provides-Extra: minimax
-Requires-Dist: openai>=1.0.0; extra == "minimax"
-Provides-Extra: all
-Requires-Dist: openai>=1.0.0; extra == "all"
-Requires-Dist: anthropic>=0.18.0; extra == "all"
-Requires-Dist: requests>=2.28.0; extra == "all"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
-Dynamic: license-file
-
-# Cognitive Modules
-
-> 可验证的结构化 AI 任务规范
-
-Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、可验证、可审计**的生成任务设计。
-
-## 与 Skills 的区别
-
-| | Skills | Cognitive Modules |
-|---|--------|------------------|
-| 定位 | 轻量指令扩展 | 可验证的结构化任务 |
-| 输入校验 | 无 | JSON Schema |
-| 输出校验 | 无 | JSON Schema |
-| 置信度 | 无 | 必须 0-1 |
-| 推理过程 | 无 | 必须 rationale |
-| 适用场景 | 快捷命令 | 规范生成、设计文档 |
-
-## 快速开始
-
-```bash
-# 克隆
-git clone https://github.com/leizii/cognitive-modules.git
-cd cognitive-modules
-
-# 安装依赖
-pip install typer rich jsonschema pyyaml
-
-# 运行
-./cog --help
-```
-
-## CLI 命令
-
-```bash
-# 模块管理
-cog list                    # 列出已安装模块
-cog info <module>           # 查看模块详情
-cog validate <module>       # 验证模块结构
-
-# 创建模块
-cog init <name> -d "描述"    # 从模板创建新模块
-
-# 运行模块
-cog run <module> input.json -o output.json --pretty
-
-# 直接传参数（无需 JSON 文件）
-cog run <module> --args "你的需求描述" -o output.json
-
-# 启用子代理模式（支持 @call 调用其他模块）
-cog run <module> --args "需求" --subagent
-
-# 安装/卸载
-cog install <source>        # 从 git/本地/注册表安装
-cog uninstall <module>      # 卸载模块
-
-# 注册表
-cog registry                # 查看公共模块
-cog search <query>          # 搜索模块
-
-# 环境检查
-cog doctor                  # 检查 LLM 配置
-```
-
-## 安装来源
-
-```bash
-# 从本地安装
-cog install ./path/to/module
-
-# 从 GitHub 安装
-cog install github:leizii/cognitive-modules/cognitive/modules/ui-spec-generator
-
-# 从注册表安装
-cog install registry:ui-spec-generator
-```
-
-## 模块格式
-
-### 新格式（推荐，2 文件）
-
-```
-my-module/
-├── MODULE.md       # 元数据 + 指令
-├── schema.json     # 输入输出 Schema
-└── examples/       # 可选
-    ├── input.json
-    └── output.json
-```
-
-### 旧格式（兼容，6 文件）
-
-```
-my-module/
-├── module.md
-├── input.schema.json
-├── output.schema.json
-├── constraints.yaml
-├── prompt.txt
-└── examples/
-```
-
-## MODULE.md 格式
-
-```yaml
----
-name: my-module
-version: 1.0.0
-responsibility: 一句话描述
-
-excludes:
-  - 不做的事情
-
-constraints:
-  no_network: true
-  no_inventing_data: true
-  require_confidence: true
-  require_rationale: true
----
-
-# 指令内容
-
-（这里写 prompt）
-```
-
-## 在 Codex / Cursor 中使用
-
-### 方式 1：直接对话（零配置）
-
-```
-读取 ~/.cognitive/modules/ui-spec-generator/MODULE.md，
-为电商首页生成 UI 规范，保存到 ui-spec.json
-```
-
-### 方式 2：AGENTS.md（项目约定）
-
-在项目根目录创建 `AGENTS.md`：
-
-```markdown
-## UI 规范生成
-
-当需要生成 UI 规范时：
-1. 读取 `~/.cognitive/modules/ui-spec-generator/MODULE.md`
-2. 按 schema.json 格式输出
-3. 保存到 ui-spec.json
-```
-
-### 方式 3：包装成 Skill
-
-```yaml
-# ~/.claude/skills/ui-spec/SKILL.md
----
-name: ui-spec
-description: 生成 UI 规范
----
-执行 ~/.cognitive/modules/ui-spec-generator/MODULE.md
-```
-
-## 配置 LLM（仅 CLI 需要）
-
-```bash
-# OpenAI
-export LLM_PROVIDER=openai
-export OPENAI_API_KEY=sk-xxx
-
-# Anthropic Claude
-export LLM_PROVIDER=anthropic
-export ANTHROPIC_API_KEY=sk-ant-xxx
-
-# Ollama（本地免费）
-export LLM_PROVIDER=ollama
-
-# 不配置则使用 stub（返回示例输出）
-```
-
-## 模块搜索路径
-
-模块按以下顺序查找：
-
-1. `./cognitive/modules/` - 项目本地
-2. `~/.cognitive/modules/` - 用户全局
-3. `$COGNITIVE_MODULES_PATH` - 自定义路径
-
-## 创建新模块
-
-```bash
-# 1. 创建骨架
-cog init my-module -d "模块职责描述"
-
-# 2. 编辑 MODULE.md 添加指令
-# 3. 编辑 schema.json 定义输入输出
-# 4. 验证
-cog validate my-module
-
-# 5. 全局安装（可选）
-cog install ./cognitive/modules/my-module
-```
-
-## 内置模块
-
-### ui-spec-generator
-
-将产品需求转换为前端可实现的 UI 规范。
-
-**输出包含**：
-- 信息架构（sections + hierarchy）
-- 组件定义（type, props, states）
-- 交互设计（events, transitions）
-- 响应式规则（breakpoints, layout）
-- 可访问性（WCAG 要求）
-- 验收标准（可测试条件）
-- 置信度 + 推理过程
-
-```bash
-cog run ui-spec-generator examples/input.json -o ui-spec.json --pretty
-```
-
-## 项目结构
-
-```
-cognitive-modules/
-├── README.md               # 本文件
-├── SPEC.md                 # 规范文档
-├── INTEGRATION.md          # Agent 集成指南
-├── AGENTS.md               # Agent 约定示例
-├── cognitive-registry.json # 公共模块注册表
-├── src/cognitive/          # CLI 源码
-│   ├── cli.py              # 命令入口
-│   ├── loader.py           # 模块加载（支持新旧格式）
-│   ├── runner.py           # 模块执行
-│   ├── validator.py        # 模块验证
-│   ├── registry.py         # 模块发现与安装
-│   ├── templates.py        # 模块模板
-│   └── providers/          # LLM 后端
-├── cognitive/modules/      # 内置模块
-│   └── ui-spec-generator/
-└── pyproject.toml
-```
-
-## 文档
-
-- [SPEC.md](SPEC.md) - 完整规范文档
-- [INTEGRATION.md](INTEGRATION.md) - Agent 工具集成指南
-- [AGENTS.md](AGENTS.md) - Agent 约定示例
-
-## License
-
-MIT