code2skill 0.1.2__tar.gz → 0.1.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. {code2skill-0.1.2 → code2skill-0.1.3}/PKG-INFO +47 -5
  2. code2skill-0.1.2/src/code2skill.egg-info/PKG-INFO → code2skill-0.1.3/README.md +506 -497
  3. {code2skill-0.1.2 → code2skill-0.1.3}/pyproject.toml +4 -3
  4. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/__init__.py +1 -1
  5. code2skill-0.1.2/README.md → code2skill-0.1.3/src/code2skill.egg-info/PKG-INFO +539 -465
  6. {code2skill-0.1.2 → code2skill-0.1.3}/LICENSE +0 -0
  7. {code2skill-0.1.2 → code2skill-0.1.3}/MANIFEST.in +0 -0
  8. {code2skill-0.1.2 → code2skill-0.1.3}/setup.cfg +0 -0
  9. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/__main__.py +0 -0
  10. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/adapt.py +0 -0
  11. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/analyzers/__init__.py +0 -0
  12. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/analyzers/project_classifier.py +0 -0
  13. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/analyzers/rules_analyzer.py +0 -0
  14. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/analyzers/skill_blueprint_builder.py +0 -0
  15. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/analyzers/workflow_analyzer.py +0 -0
  16. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/cli.py +0 -0
  17. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/config.py +0 -0
  18. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/core.py +0 -0
  19. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/costing.py +0 -0
  20. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/extractors/__init__.py +0 -0
  21. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/extractors/base.py +0 -0
  22. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/extractors/config_extractor.py +0 -0
  23. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/extractors/python_extractor.py +0 -0
  24. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/git_client.py +0 -0
  25. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/impact.py +0 -0
  26. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/import_graph.py +0 -0
  27. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/json_utils.py +0 -0
  28. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/llm_backend.py +0 -0
  29. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/models.py +0 -0
  30. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/pattern_detector.py +0 -0
  31. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/python_imports.py +0 -0
  32. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/renderers/__init__.py +0 -0
  33. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/renderers/json_renderer.py +0 -0
  34. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/renderers/markdown_renderer.py +0 -0
  35. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/__init__.py +0 -0
  36. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/budget.py +0 -0
  37. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/detector.py +0 -0
  38. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/filters.py +0 -0
  39. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/prioritizer.py +0 -0
  40. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/scanner/repository.py +0 -0
  41. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/skill_generator.py +0 -0
  42. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/skill_planner.py +0 -0
  43. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill/state_store.py +0 -0
  44. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill.egg-info/SOURCES.txt +0 -0
  45. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill.egg-info/dependency_links.txt +0 -0
  46. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill.egg-info/entry_points.txt +0 -0
  47. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill.egg-info/requires.txt +0 -0
  48. {code2skill-0.1.2 → code2skill-0.1.3}/src/code2skill.egg-info/top_level.txt +0 -0
{code2skill-0.1.2 → code2skill-0.1.3}/PKG-INFO RENAMED
@@ -1,14 +1,14 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: code2skill
3
- Version: 0.1.2
4
- Summary: Turn a code repository into structured AI skill context.
3
+ Version: 0.1.3
4
+ Summary: Generate grounded AI coding assistant skills and repository blueprints from real Python codebases.
5
5
  Author: OceanusXXD
6
6
  License-Expression: Apache-2.0
7
7
  Project-URL: Homepage, https://github.com/oceanusXXD/code2skill
8
8
  Project-URL: Repository, https://github.com/oceanusXXD/code2skill
9
9
  Project-URL: Documentation, https://github.com/oceanusXXD/code2skill#readme
10
10
  Project-URL: Issues, https://github.com/oceanusXXD/code2skill/issues
11
- Keywords: ai,cli,developer-tools,skills
11
+ Keywords: ai,python,repository-analysis,skills,codex,cursor,claude-code,copilot
12
12
  Classifier: Development Status :: 3 - Alpha
13
13
  Classifier: Environment :: Console
14
14
  Classifier: Intended Audience :: Developers
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
19
19
  Classifier: Programming Language :: Python :: 3.11
20
20
  Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Topic :: Software Development :: Build Tools
22
+ Classifier: Topic :: Utilities
22
23
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
24
  Requires-Python: >=3.10
24
25
  Description-Content-Type: text/markdown
@@ -32,12 +33,53 @@ Dynamic: license-file
32
33
 
33
34
  # code2skill
34
35
 
36
+ [![PyPI version](https://img.shields.io/pypi/v/code2skill)](https://pypi.org/project/code2skill/)
37
+ [![Python versions](https://img.shields.io/pypi/pyversions/code2skill)](https://pypi.org/project/code2skill/)
38
+ [![License](https://img.shields.io/pypi/l/code2skill)](https://github.com/oceanusXXD/code2skill/blob/main/LICENSE)
39
+
35
40
  中文优先，后附英文快速说明。
36
41
  Chinese first, with an English quick reference at the end.
37
42
 
38
- `code2skill` 是一个面向 Python 仓库的 CLI。它会把真实代码仓库编译成一组结构化项目知识和 Skill 文档，供 Cursor、Claude Code、Codex、Copilot、Windsurf 等 AI 编程助手消费。
43
+ `code2skill` 是一个面向 Python 仓库的 CLI。它会把真实代码仓库转换成结构化项目知识、AI 可消费的 Skill 文档，以及可以直接适配到 Cursor、Claude Code、Codex、Copilot、Windsurf 的规则文件。
44
+
45
+ 它的目标不是“总结仓库”，而是生成能直接用于后续编码、审查、补丁编写和增量更新的高密度上下文。
46
+
47
+ 核心定位：
48
+
49
+ - 输入：一个真实 Python 仓库
50
+ - 中间产物：`project-summary.md`、`skill-blueprint.json`、`skill-plan.json`
51
+ - 最终产物：`skills/*.md`、`AGENTS.md`、`CLAUDE.md`、`copilot-instructions.md` 等 AI 规则文件
52
+ - 目标工具：Cursor、Claude Code、Codex、GitHub Copilot、Windsurf
53
+
54
+ 如果你在找下面这些能力，这个项目就是为此设计的：
55
+
56
+ - Python repository analysis for AI coding assistants
57
+ - Generate Cursor rules / Codex `AGENTS.md` / Claude Code docs from source code
58
+ - Turn a backend repository into reusable AI skills instead of one-off prompts
59
+ - Keep AI repo knowledge incrementally updated in CI
60
+
61
+ ## 为什么它更适合 AI 消费
62
+
63
+ - 先做结构扫描，再做 Skill 规划，最后生成可复用文档，而不是一次性长 prompt
64
+ - Phase 1 不依赖 LLM，先把目录、import、角色、模式、规则和流程提纯
65
+ - 输出是稳定文件，不是聊天记录，后续可以直接复用、提交和增量更新
66
+ - 支持把生成结果落到不同 IDE/Agent 约定位置，而不是手动复制粘贴
67
+
68
+ ## 你会得到什么
69
+
70
+ - `project-summary.md`：面向人快速浏览的项目概览
71
+ - `skill-blueprint.json`：Phase 1 的结构化仓库蓝图
72
+ - `skill-plan.json`：LLM 规划出的 Skill 列表和阅读文件
73
+ - `skills/index.md`：Skill 索引
74
+ - `skills/*.md`：真正给 AI 编程助手消费的领域规则文档
75
+ - `AGENTS.md` / `CLAUDE.md` / `.cursor/rules/*`：适配后的 IDE 产物
76
+
77
+ ## 典型使用场景
39
78
 
40
- 它的目标不是“总结仓库”，而是生成能直接用于后续编码、审查和增量更新的高密度上下文。
79
+ - 给一个已有 Python 后端仓库补齐 Cursor / Codex / Claude Code 规则
80
+ - 在 CI 里根据 diff 自动重建受影响的 Skill
81
+ - 给团队沉淀一套来自真实代码而不是口头约定的开发规范
82
+ - 给 AI 编程工具提供 grounded repository context，减少幻觉和误判
41
83
 
42
84
  ## 适用范围
43
85