@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/hooks/inject-workflow-state.py

@@ -1,169 +0,0 @@
-# inject-workflow-state.py - Inject workflow state on every message
-import os, json, sys
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except Exception:
-        pass
-
-NL = chr(10)
-BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-# mtime 缓存 (审计 H5: 每条用户消息都跑这个 hook, 缓存避免重复读盘)
-# 格式: {filepath: (mtime, parsed_value)}
-_CACHE = {}
-
-
-def _append_hook_error(log_path, line):
-    """写一行错误到 hook-errors.log, 超 100KB 截断保留最后 50KB (防无限膨胀)。
-
-    best-effort: 任何 IO 失败都静默 (不能让日志写入失败导致 hook 二次崩溃)。
-    """
-    from datetime import datetime
-    try:
-        os.makedirs(os.path.dirname(log_path), exist_ok=True)
-        # 轮转: 文件过大则截断
-        if os.path.isfile(log_path):
-            try:
-                if os.path.getsize(log_path) > 100 * 1024:
-                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
-                        tail = f.read()[-50 * 1024:]
-                    with open(log_path, 'w', encoding='utf-8') as f:
-                        f.write(tail)
-            except OSError:
-                pass
-        with open(log_path, 'a', encoding='utf-8') as f:
-            f.write('[{}] inject-workflow-state: {}\n'.format(
-                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200]))
-    except Exception:
-        pass
-
-
-def _read_developer():
-    """读当前开发者名 (容错: UTF-8/GBK)."""
-    df = os.path.join(BASE, '.qoder', '.developer')
-    if not os.path.isfile(df):
-        return None
-    for enc in ('utf-8', 'gbk', 'utf-8-sig'):
-        try:
-            with open(df, encoding=enc) as f:
-                for line in f:
-                    line = line.strip()
-                    if line.startswith('name='):
-                        return line.split('=', 1)[1].strip()
-                    if line.startswith('name:') or ':' in line:
-                        # 容错 name: x 格式
-                        for sep in ('=', ':'):
-                            if sep in line:
-                                k, v = line.split(sep, 1)
-                                if k.strip() == 'name':
-                                    return v.strip()
-        except (OSError, UnicodeDecodeError):
-            continue
-    return None
-
-
-def _cached_read(path, parser):
-    """带 mtime 缓存的文件读。parser: callable(content_str) -> value."""
-    try:
-        mtime = os.path.getmtime(path)
-    except OSError:
-        return None
-    cached = _CACHE.get(path)
-    if cached and cached[0] == mtime:
-        return cached[1]
-    # 重读
-    for enc in ('utf-8', 'gbk', 'utf-8-sig'):
-        try:
-            with open(path, encoding=enc) as f:
-                content = f.read()
-            value = parser(content)
-            _CACHE[path] = (mtime, value)
-            return value
-        except (OSError, UnicodeDecodeError):
-            continue
-    return None
-
-
-def get_status():
-    # 优先读按开发者隔离的 current-task 文件
-    dev = _read_developer()
-    ct_candidates = []
-    if dev:
-        safe = ''.join(c for c in dev if c.isalnum() or c in '_-') or 'anon'
-        ct_candidates.append(os.path.join(BASE, '.qoder', '.runtime', 'current-task.' + safe))
-    ct_candidates.append(os.path.join(BASE, '.qoder', '.current-task'))  # 旧格式回退
-
-    rel = None
-    for ct in ct_candidates:
-        rel = _cached_read(ct, lambda c: c.strip() or None)
-        if rel:
-            break
-    if not rel:
-        return None, None
-
-    tj = os.path.join(BASE, rel, 'task.json')
-    if os.path.isfile(tj):
-        d = _cached_read(tj, lambda c: json.loads(c) if c.strip() else None)
-        if d:
-            return rel, d.get('status', 'unknown')
-    return rel, None
-
-
-# Statuses written by task.py: planning -> in_progress -> completed
-GUIDE = {
-    None: 'No active task. Use /wl-prd-full to start, or /wl-task create.',
-    'planning': 'Task in planning. Use /wl-prd-full to write the PRD, then /wl-task start.',
-    'in_progress': 'Dev in progress. /wl-spec to generate spec, /wl-code to implement.',
-    'completed': 'Task completed. /wl-task archive to archive, or start the next one.',
-}
-
-
-def main():
-    tp, st = get_status()
-    # Hook-2: 如果任务/状态没变, 输出空 (减少 token 消耗)
-    # 用 .runtime/.last-workflow-state 存上次输出, mtime 变了才重新注入
-    state_file = os.path.join(BASE, '.qoder', '.runtime', '.last-wf-state.txt')
-    current_sig = '{}|{}'.format(tp or '', st or '')
-    try:
-        os.makedirs(os.path.dirname(state_file), exist_ok=True)
-        if os.path.isfile(state_file):
-            last_sig = open(state_file, 'r', encoding='utf-8').read().strip()
-            if last_sig == current_sig:
-                # 状态没变, 不重复注入 (省 token), 但仍输出健康标记
-                # QoderWork 看不到任何输出时分不清"缓存跳过"还是"hook 没跑"
-                print('<!-- [hook-ok] inject-workflow-state: state unchanged (cached) -->')
-                return
-        open(state_file, 'w', encoding='utf-8').write(current_sig)
-    except OSError:
-        pass
-
-    g = GUIDE.get(st, 'Status "{}" - check task.json, expected planning/in_progress/completed.'.format(st))
-    parts = []
-    parts.append('<qoder-workflow>')
-    if tp:
-        parts.append('Task: ' + tp)
-    parts.append('Status: ' + str(st))
-    parts.append('Do: ' + g)
-    parts.append('</qoder-workflow>')
-    # Hook-1: 健康标记 — 与 session-start 一致, QoderWork 看不到说明 hook 没生效
-    parts.append('<!-- [hook-ok] inject-workflow-state hook ran -->')
-    print(NL.join(parts))
-
-
-if __name__ == '__main__':
-    try:
-        main()
-    except Exception as e:
-        # 落盘到日志 (stdout 一次性, 追溯用)
-        try:
-            from pathlib import Path
-            log_path = str(Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log')
-            _append_hook_error(log_path, str(e)[:200])
-        except Exception:
-            pass
-        print('<qoder-workflow>')
-        print('hook error: ' + str(e)[:200])
-        print('  (详情见 .qoder/.runtime/hook-errors.log)')
-        print('</qoder-workflow>')

package/templates/qoder/scripts/check_carriers.py

@@ -1,238 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-check_carriers.py - 四载体一致性守卫 (防 IDE/Quest/CLI/QoderWork 漂移)
-
-背景:
-  AGENTS.md 自己写了"改规则要同步更新它和 .qoder/rules/wl-pipeline.md"。
-  四个载体 (IDE commands / Quest skills / CLI AGENTS.md / QoderWork) 描述同一个
-  命令, 如果只改一个就漂移了 —— 比如 IDE 里 /wl-test 说要跑单测, 但 QoderWork 的
-  skill 还停在旧版。目前没有任何机制发现, git status 里的 sync_templates.py M 状态
-  就是手工同步的证据。
-
-  check_qoderwork_consistency.py 只查"裸相对路径"这一种退化。
-  本脚本查"内容一致性": 同名命令的描述是否对得上、AGENTS.md 命令表是否齐全。
-
-Usage:
-    python .qoder/scripts/check_carriers.py
-    python .qoder/scripts/check_carriers.py --strict   # 警告也算失败
-Exit:
-    0 = 四载体一致
-    1 = 发现漂移 (errors)
-"""
-import argparse
-import os
-import re
-import sys
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except (AttributeError, IOError):
-        pass
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from common.paths import get_repo_root
-
-BASE = get_repo_root()
-COMMANDS_DIR = BASE / '.qoder' / 'commands'
-SKILLS_DIR = BASE / '.qoder' / 'skills'
-AGENTS_MD = BASE / 'AGENTS.md'
-
-# description 相似度阈值 (改了标点/措辞不算漂移, 实质改变才算)
-DESC_SIMILAR_THRESHOLD = 0.6
-
-
-def _read_yaml_frontmatter(path):
-    """读 .md 的 YAML frontmatter, 返回 dict (无则空)。"""
-    try:
-        text = path.read_text(encoding='utf-8', errors='ignore')
-    except OSError:
-        return {}
-    if not text.startswith('---'):
-        return {}
-    parts = text.split('---', 2)
-    if len(parts) < 3:
-        return {}
-    fm = {}
-    for line in parts[1].splitlines():
-        line = line.strip()
-        if ':' in line:
-            k, _, v = line.partition(':')
-            fm[k.strip()] = v.strip().strip('"\'')
-    return fm
-
-
-def _similarity(a, b):
-    """两字符串的相似度 (0~1), 用SequenceRatio。None/空 = 0。"""
-    if not a or not b:
-        return 0.0
-    from difflib import SequenceMatcher
-    return SequenceMatcher(None, a.lower(), b.lower()).ratio()
-
-
-def _prefix_consistent(cmd_desc, skill_desc):
-    """判断 command description 是否是 skill description 的"精简前缀版本"。
-
-    设计意图: sync_carriers 把 skill 的 description 截断到触发词前, 写进 command。
-    所以 command = skill 的核心前缀, skill 后面挂触发词。这不是漂移, 是设计如此。
-
-    判定: command 是 skill 的前缀 (忽略大小写), 或 command 覆盖了 skill 的核心部分。
-    返回 True = 一致 (设计如此), False = 需进一步用相似度判断。
-    """
-    if not cmd_desc or not skill_desc:
-        return False
-    c, s = cmd_desc.lower().strip(), skill_desc.lower().strip()
-    # 1. command 是 skill 的前缀 (最常见: sync 后 command = skill 截断版)
-    if s.startswith(c):
-        return True
-    # 2. command 覆盖了 skill 的核心 (skill 去掉触发词后 == command)
-    #    触发词标记 (和 sync_carriers._condense_description 对齐)
-    for marker in ['。用户说', '；用户说', ' 用户说', '。触发:', ' 触发:', '；触发', '时触发']:
-        idx = s.find(marker)
-        if idx > 0:
-            skill_core = s[:idx + 1]  # 含句号/分号
-            if skill_core.startswith(c) or c.startswith(skill_core):
-                return True
-            # 核心部分相似度高也算 (措辞微调)
-            if _similarity(c, skill_core) >= 0.85:
-                return True
-    return False
-
-
-def check_command_skill_pairing():
-    """校验 commands/wl-X.md 和 skills/wl-X/SKILL.md 的 description 是否一致。
-    返回 (errors, warnings)。
-    """
-    errors = []
-    warnings = []
-
-    # 收集所有 command (含 optional/ 子目录)
-    commands = {}
-    if COMMANDS_DIR.is_dir():
-        for path in COMMANDS_DIR.rglob('*.md'):
-            name = path.stem  # wl-test
-            commands[name] = path
-
-    # 收集所有 skill
-    skills = {}
-    if SKILLS_DIR.is_dir():
-        for d in SKILLS_DIR.iterdir():
-            if d.is_dir() and (d / 'SKILL.md').is_file():
-                skills[d.name] = d / 'SKILL.md'
-
-    # 配对校验 (command 和 skill 同名才校验, 不同名是设计如此)
-    common_names = set(commands) & set(skills)
-    for name in sorted(common_names):
-        cmd_fm = _read_yaml_frontmatter(commands[name])
-        skill_fm = _read_yaml_frontmatter(skills[name])
-        cmd_desc = cmd_fm.get('description', '')
-        skill_desc = skill_fm.get('description', '')
-        if not cmd_desc or not skill_desc:
-            continue  # 没写的跳过
-        # 一致性判断: 不只用字符相似度, 还判断"command 是否是 skill 的精简前缀版本"
-        # (sync_carriers 产生的就是这个关系: command = skill 去掉触发词后的核心描述)
-        # 这样度量才符合设计意图, 不会把"故意精简"误报成漂移。
-        if _prefix_consistent(cmd_desc, skill_desc):
-            continue  # command 是 skill 的精简版 = 一致, 通过
-        sim = _similarity(cmd_desc, skill_desc)
-        if sim < DESC_SIMILAR_THRESHOLD:
-            errors.append((
-                name,
-                'description 严重不一致 (相似度 %.0f%%, 阈值 %d%%)' % (sim * 100, DESC_SIMILAR_THRESHOLD * 100),
-                'command: ' + cmd_desc[:60],
-                'skill:    ' + skill_desc[:60],
-            ))
-        elif sim < 0.85:
-            warnings.append((
-                name,
-                'description 有差异 (相似度 %.0f%%), 建议核对' % (sim * 100),
-            ))
-
-    return errors, warnings
-
-
-def check_agents_md_command_table():
-    """校验 AGENTS.md 的 7 核心命令表与实际文件是否对得上。
-    表里列了但文件不存在 = 漂移 (改了命令没改文档, 或反之)。
-    """
-    errors = []
-    if not AGENTS_MD.is_file():
-        return [('AGENTS.md', 'AGENTS.md 不存在 (CLI 载体缺失)', '', '')]
-    text = AGENTS_MD.read_text(encoding='utf-8', errors='ignore')
-
-    # 提取"7 Core Commands"表里的命令名 (形如 `/wl-init`)
-    # 表格行格式: | `/wl-init` | ... |
-    table_cmds = set()
-    in_core_table = False
-    for line in text.splitlines():
-        s = line.strip()
-        if '7 Core' in line or '核心命令' in line:
-            in_core_table = True
-        if in_core_table:
-            for m in re.finditer(r'`(/wl-[a-z-]+)`', s):
-                table_cmds.add(m.group(1)[1:])  # 去掉 / 前缀
-        if in_core_table and s.startswith('|') and '工序站' in text and s.count('|') >= 2:
-            # 表还在继续
-            pass
-
-    # 校验每个表里的命令文件存在
-    for cmd in sorted(table_cmds):
-        cmd_file = COMMANDS_DIR / (cmd + '.md')
-        skill_file = SKILLS_DIR / cmd / 'SKILL.md'
-        if not cmd_file.is_file() and not skill_file.is_file():
-            errors.append((
-                cmd,
-                'AGENTS.md 命令表列了 /%s 但 commands/ 和 skills/ 都没文件' % cmd,
-                '',
-                '',
-            ))
-
-    return errors
-
-
-def main():
-    ap = argparse.ArgumentParser(description='四载体一致性守卫 (防漂移)')
-    ap.add_argument('--strict', action='store_true', help='警告也算失败')
-    args = ap.parse_args()
-
-    print('=' * 64)
-    print('四载体一致性检查 (IDE commands / Quest skills / CLI AGENTS.md / QoderWork)')
-    print('=' * 64)
-
-    pair_errors, pair_warnings = check_command_skill_pairing()
-    table_errors = check_agents_md_command_table()
-
-    all_errors = pair_errors + table_errors
-
-    if pair_warnings:
-        print('\n🟡 描述差异 (建议核对, --strict 才算失败):')
-        for name, msg, *_ in pair_warnings:
-            print('  %s: %s' % (name, msg))
-
-    if all_errors:
-        print('\n🔴 载体漂移 (必修):')
-        for item in all_errors:
-            name = item[0]
-            print('  %s' % name)
-            for detail in item[1:]:
-                if detail:
-                    print('    %s' % detail)
-
-    if not all_errors and not pair_warnings:
-        print('✅ 四载体一致: 同名命令描述对得上, AGENTS.md 命令表齐全。')
-
-    print('-' * 64)
-    print('统计: 漂移 %d / 差异 %d' % (len(all_errors), len(pair_warnings)))
-    print('提示: 与 check_qoderwork_consistency.py 互补 ——')
-    print('  那个查裸相对路径, 这个查内容一致性。')
-
-    if all_errors:
-        return 1
-    if args.strict and pair_warnings:
-        return 1
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())