release: publish 0.1.2

Author: oceanusXXD

README.md

@@ -32,7 +32,15 @@ Chinese first, with an English quick reference at the end.
 ```bash
 export QWEN_API_KEY=...
 export CODE2SKILL_LLM=qwen
-export CODE2SKILL_MODEL=qwen-plus
+export CODE2SKILL_MODEL=qwen-plus-latest
+```
+
+PowerShell:
+
+```powershell
+$env:QWEN_API_KEY="..."
+$env:CODE2SKILL_LLM="qwen"
+$env:CODE2SKILL_MODEL="qwen-plus-latest"
 ```
 
 进入要分析的仓库目录后直接运行：
@@ -88,16 +96,34 @@ export ANTHROPIC_API_KEY=...
 export QWEN_API_KEY=...
 ```
 
+PowerShell:
+
+```powershell
+$env:OPENAI_API_KEY="..."
+$env:ANTHROPIC_API_KEY="..."
+$env:QWEN_API_KEY="..."
+```
+
 CLI 默认值：
 
 ```bash
 export CODE2SKILL_LLM=qwen
-export CODE2SKILL_MODEL=qwen-plus
+export CODE2SKILL_MODEL=qwen-plus-latest
 export CODE2SKILL_OUTPUT_DIR=.code2skill
 export CODE2SKILL_MAX_SKILLS=6
 export CODE2SKILL_BASE_REF=origin/main
 ```
 
+PowerShell:
+
+```powershell
+$env:CODE2SKILL_LLM="qwen"
+$env:CODE2SKILL_MODEL="qwen-plus-latest"
+$env:CODE2SKILL_OUTPUT_DIR=".code2skill"
+$env:CODE2SKILL_MAX_SKILLS="6"
+$env:CODE2SKILL_BASE_REF="origin/main"
+```
+
 说明：
 
 - `qwen` 默认走阿里国际站兼容接口
@@ -109,7 +135,7 @@ export CODE2SKILL_BASE_REF=origin/main
 完整扫描并生成 Skill：
 
 ```bash
-code2skill scan --llm qwen --model qwen-plus
+code2skill scan --llm qwen --model qwen-plus-latest
 ```
 
 只做结构扫描：
@@ -298,7 +324,7 @@ jobs:
         env:
           QWEN_API_KEY: ${{ secrets.QWEN_API_KEY }}
           CODE2SKILL_LLM: qwen
-          CODE2SKILL_MODEL: qwen-plus
+          CODE2SKILL_MODEL: qwen-plus-latest
         run: |
           code2skill ci \
             --mode auto \
@@ -392,7 +418,16 @@ From the target repo root:
 ```bash
 export QWEN_API_KEY=...
 export CODE2SKILL_LLM=qwen
-export CODE2SKILL_MODEL=qwen-plus
+export CODE2SKILL_MODEL=qwen-plus-latest
+code2skill scan
+```
+
+PowerShell:
+
+```powershell
+$env:QWEN_API_KEY="..."
+$env:CODE2SKILL_LLM="qwen"
+$env:CODE2SKILL_MODEL="qwen-plus-latest"
 code2skill scan
 ```
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2skill"
-version = "0.1.1"
+version = "0.1.2"
 description = "Turn a code repository into structured AI skill context."
 readme = "README.md"
 requires-python = ">=3.10"

src/code2skill/__init__.py

@@ -4,7 +4,7 @@
 
 from typing import TYPE_CHECKING, Any
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 
 __all__ = [
     "ScanExecution",

src/code2skill/cli.py

@@ -23,7 +23,7 @@ def build_parser() -> argparse.ArgumentParser:
         ),
         epilog=(
             "示例:\n"
-            "  code2skill scan --llm qwen --model qwen-plus\n"
+            "  code2skill scan --llm qwen --model qwen-plus-latest\n"
             "  code2skill ci --mode auto --base-ref origin/main --llm qwen\n"
             "  code2skill adapt --target codex"
         ),
@@ -138,6 +138,8 @@ def main(argv: Sequence[str] | None = None) -> int:
         print(f"changed_files: {len(result.changed_files)}")
     if result.affected_skills:
         print(f"affected_skills: {', '.join(result.affected_skills)}")
+    if result.generated_skills:
+        print(f"generated_skills: {', '.join(result.generated_skills)}")
     print(f"output_dir: {result.output_dir}")
     if result.report_path is not None:
         print(f"report: {result.report_path}")

src/code2skill/core.py

@@ -68,7 +68,11 @@ def execute_repository(config: ScanConfig) -> ScanExecution:
     state_store = StateStore(output_dir)
     previous_state = state_store.load()
     changed_diffs = _detect_changed_diffs(config, previous_state, git_client)
-    changed_files = _changed_paths_from_diffs(changed_diffs)
+    changed_files = _changed_paths_from_diffs(
+        changed_diffs=changed_diffs,
+        repo_path=repo_path,
+        output_dir=output_dir,
+    )
     effective_mode, notes = _choose_effective_mode(
         config=config,
         previous_state=previous_state,
@@ -155,8 +159,14 @@ def execute_repository(config: ScanConfig) -> ScanExecution:
     patch_cost = cost_estimator.estimate_incremental_patch(rewrite_cost)
 
     skill_artifacts: dict[str, str] = {}
+    generated_skill_names: list[str] = []
+    planned_skill_names: list[str] = []
     if _should_run_skill_pipeline(config):
-        skill_artifacts = _build_skill_artifacts(
+        (
+            skill_artifacts,
+            generated_skill_names,
+            planned_skill_names,
+        ) = _build_skill_artifacts(
             config=config,
             effective_mode=effective_mode,
             repo_path=repo_path,
@@ -177,6 +187,13 @@ def execute_repository(config: ScanConfig) -> ScanExecution:
             output_dir=output_dir,
             rendered_artifacts=rendered_artifacts,
         )
+        if planned_skill_names:
+            updated_files.extend(
+                _prune_stale_skill_files(
+                    output_dir=output_dir,
+                    planned_skill_names=planned_skill_names,
+                )
+            )
 
     report = _build_report(
         config=config,
@@ -188,6 +205,7 @@ def execute_repository(config: ScanConfig) -> ScanExecution:
         changed_files=changed_files,
         affected_files=affected_files,
         affected_skills=affected_skills,
+        generated_skills=generated_skill_names,
         written_files=written_files,
         updated_files=updated_files,
         head_commit=git_client.current_head() if git_client.is_repository() else None,
@@ -232,6 +250,7 @@ def execute_repository(config: ScanConfig) -> ScanExecution:
         changed_files=changed_files,
         affected_files=affected_files,
         affected_skills=affected_skills,
+        generated_skills=generated_skill_names,
         report_path=report_path,
         report=report,
     )
@@ -615,8 +634,50 @@ def _detect_changed_diffs(
     return []
 
 
-def _changed_paths_from_diffs(changed_diffs: list[FileDiffPatch]) -> list[str]:
-    return sorted({item.path for item in changed_diffs})
+def _changed_paths_from_diffs(
+    changed_diffs: list[FileDiffPatch],
+    repo_path: Path,
+    output_dir: Path,
+) -> list[str]:
+    return sorted(
+        {
+            item.path
+            for item in changed_diffs
+            if item.path
+            and not _is_generated_artifact_path(
+                path=item.path,
+                repo_path=repo_path,
+                output_dir=output_dir,
+            )
+        }
+    )
+
+
+def _is_generated_artifact_path(
+    path: str,
+    repo_path: Path,
+    output_dir: Path,
+) -> bool:
+    normalized = Path(path).as_posix()
+    first_part = normalized.split("/", 1)[0]
+    if first_part.startswith(".code2skill"):
+        return True
+    if normalized in {"AGENTS.md", "CLAUDE.md", ".windsurfrules"}:
+        return True
+    if normalized == ".github/copilot-instructions.md":
+        return True
+    if normalized == ".cursor/rules" or normalized.startswith(".cursor/rules/"):
+        return True
+
+    try:
+        relative_output_dir = output_dir.relative_to(repo_path).as_posix()
+    except ValueError:
+        return False
+
+    return (
+        normalized == relative_output_dir
+        or normalized.startswith(f"{relative_output_dir}/")
+    )
 
 
 def _choose_effective_mode(
@@ -764,7 +825,7 @@ def _build_skill_artifacts(
     changed_diffs: list[FileDiffPatch],
     affected_files: list[str],
     affected_skill_names: list[str],
-) -> dict[str, str]:
+) -> tuple[dict[str, str], list[str], list[str]]:
     from .skill_generator import SkillGenerator, match_planned_skills
     from .skill_planner import SkillPlanner, load_skill_plan, render_skill_plan
 
@@ -795,7 +856,8 @@ def _build_skill_artifacts(
             "skill-plan.json": render_skill_plan(plan),
         }
         artifacts.update(generator.generate_all(blueprint=blueprint, plan=plan))
-        return artifacts
+        planned_names = [skill.name for skill in plan.skills]
+        return artifacts, planned_names, planned_names
 
     try:
         plan = load_skill_plan(plan_path)
@@ -805,10 +867,12 @@ def _build_skill_artifacts(
             "skill-plan.json": render_skill_plan(plan),
         }
         artifacts.update(generator.generate_all(blueprint=blueprint, plan=plan))
-        return artifacts
+        planned_names = [skill.name for skill in plan.skills]
+        return artifacts, planned_names, planned_names
 
     artifacts: dict[str, str] = {}
     plan_skill_names = {skill.name for skill in plan.skills}
+    planned_names = [skill.name for skill in plan.skills]
     present_skills = [
         name for name in affected_skill_names
         if name in plan_skill_names
@@ -823,15 +887,13 @@ def _build_skill_artifacts(
         plan = planner.plan(blueprint=blueprint, repo_path=repo_path)
         artifacts["skill-plan.json"] = render_skill_plan(plan)
         plan_skill_names = {skill.name for skill in plan.skills}
-        affected_skill_names = [
-            name for name in affected_skill_names
-            if name in plan_skill_names
-        ]
-        if not affected_skill_names:
-            affected_skill_names = match_planned_skills(affected_files, plan)
+        planned_names = [skill.name for skill in plan.skills]
+        affected_skill_names = match_planned_skills(affected_files, plan)
+        artifacts.update(generator.generate_all(blueprint=blueprint, plan=plan))
+        return artifacts, planned_names, planned_names
 
     if not affected_skill_names:
-        return artifacts
+        return artifacts, [], planned_names
 
     artifacts.update(
         generator.generate_incremental(
@@ -843,7 +905,7 @@ def _build_skill_artifacts(
             previous_state=previous_state,
         )
     )
-    return artifacts
+    return artifacts, affected_skill_names, planned_names
 
 
 def build_llm_backend(provider: str, model: str | None = None):
@@ -871,6 +933,25 @@ def _write_outputs(
     return written_files, updated_files
 
 
+def _prune_stale_skill_files(
+    output_dir: Path,
+    planned_skill_names: list[str],
+) -> list[Path]:
+    skills_dir = output_dir / "skills"
+    if not skills_dir.exists():
+        return []
+
+    keep = {f"{name}.md" for name in planned_skill_names}
+    keep.add("index.md")
+    removed: list[Path] = []
+    for path in skills_dir.glob("*.md"):
+        if path.name in keep:
+            continue
+        path.unlink(missing_ok=True)
+        removed.append(path)
+    return removed
+
+
 def _build_report(
     config: ScanConfig,
     effective_mode: str,
@@ -881,6 +962,7 @@ def _build_report(
     changed_files: list[str],
     affected_files: list[str],
     affected_skills: list[str],
+    generated_skills: list[str],
     written_files: list[Path],
     updated_files: list[Path],
     head_commit: str | None,
@@ -914,6 +996,7 @@ def _build_report(
             changed_files=changed_files,
             affected_files=affected_files,
             affected_skills=affected_skills,
+            generated_skills=generated_skills,
         ),
         first_generation_cost=first_generation_cost,
         incremental_rewrite_cost=rewrite_cost,