Skip to content

CheshireMew/100x-learning / archive/writing-capability-retired-2026-09-02

100x-learning

Verified

帮助用户读懂材料、研究主题、解释概念、把知识用于真实问题,并直接写成文章;也能把字幕和自动转写稿整理成忠实、可读的文章式全文并写入私人知识库,在用户明确要求时再讲解材料或提炼知识,接入视频和社交来源,筛选分享内容,根据发布反馈继续选题和改进内容,以及初始化、检查和维护本机私人知识库、内容案例、钩子与写作记忆。适用于字幕整稿、划重点、系统学习、分轮处理长材料、内容审查、文章写作和知识沉淀;不负责短内容生成、媒体制作、普通翻译、广告投放、销售页、邮件营销、品牌全案、完整营销策略和实际发布。

FileKindSize
README.en.mdmarkdown11.8 KB
README.ja.mdmarkdown13.2 KB
README.mdmarkdown10.2 KB
RETIREMENT.mdmarkdown965 B
SKILL.mdskill md19.8 KB
assets/private-library/content-strategy.mdmarkdown938 B
assets/private-library/published-content-review.mdmarkdown970 B
assets/private-library/topic-portfolio.mdmarkdown785 B
assets/private-library/writing-memory.jsonconfig36 B
references/article-from-practice.mdmarkdown1.4 KB
references/bulk-knowledge-ingestion.previous.mdmarkdown3.3 KB
references/content-audit.mdmarkdown1.8 KB
references/content-case-library.mdmarkdown2.5 KB
references/content-strategy-and-topic-selection.mdmarkdown3.9 KB
references/content-writing.mdmarkdown3.2 KB
references/hook-library.mdmarkdown2.1 KB
references/knowledge-base-health.previous.mdmarkdown3.3 KB
references/knowledge-base-workflow.previous.mdmarkdown14.1 KB
references/natural-writing.mdmarkdown1.1 KB
references/personal-writing-memory.mdmarkdown10.4 KB
references/project-promotion-materials.mdmarkdown1.5 KB
references/publication-requirements.mdmarkdown5.9 KB
references/published-content-review.mdmarkdown3.4 KB
references/research-led-learning.previous.mdmarkdown9.1 KB
references/shareable-content-selection.previous.mdmarkdown2.5 KB
references/source-ingestion.previous.mdmarkdown3.4 KB
references/transcript-editing.previous.mdmarkdown6.1 KB
references/writing-material-preparation.mdmarkdown6.6 KB
scripts/content_case_library.pyscript16.9 KB
scripts/hook_library.pyscript11.1 KB
scripts/writing_memory.pyscript29.1 KB
tests/test_content_case_library.pyscript10.7 KB
tests/test_content_learning_loop.pyscript2.6 KB
tests/test_hook_library.pyscript10.6 KB
tests/test_promotion_writing_flow.pyscript3.5 KB
tests/test_writing_contract.pyscript27.8 KB
tests/test_writing_memory.pyscript15.8 KB

scripts/hook_library.py

View on GitHub
from __future__ import annotations

import argparse
import json
import os
import re
import sys
from dataclasses import dataclass
from pathlib import Path
from typing import Any, Sequence

try:
    from scripts.private_library import (
        LibraryError,
        LibraryLayout,
        resolve_library_root,
        validate_library,
    )
except ModuleNotFoundError:
    from private_library import (
        LibraryError,
        LibraryLayout,
        resolve_library_root,
        validate_library,
    )


METADATA_PATTERN = re.compile(
    r"\n?<!-- hook-library-index\s*\n(?P<metadata>\{.*\})\n-->\s*$",
    re.DOTALL,
)

TECHNIQUE_ORDER = (
    "利益先行",
    "结果先行",
    "变化先行",
    "问题切入",
    "冲突切入",
    "反常识切入",
    "场景切入",
    "故事切入",
    "信息缺口",
    "对象亮相",
    "数字切入",
    "清单承诺",
    "亲历切入",
    "观点先行",
)
SUPPORTED_TECHNIQUES = set(TECHNIQUE_ORDER)


class HookError(ValueError):
    pass


@dataclass(frozen=True)
class HookExample:
    path: Path
    hook_id: str
    title: str
    technique: str
    text: str


def _safe_segment(value: str, field: str) -> str:
    cleaned = value.strip()
    if (
        not cleaned
        or cleaned in {".", ".."}
        or any(character in cleaned for character in '<>:"/\\|?*')
    ):
        raise HookError(f"{field} 不能作为目录或文件名:{value}")
    return cleaned


def _metadata_block(value: dict[str, Any]) -> str:
    return "\n".join(
        [
            "<!-- hook-library-index",
            json.dumps(value, ensure_ascii=False, sort_keys=True),
            "-->",
        ]
    )


def _parse_metadata(text: str) -> tuple[dict[str, Any], str]:
    match = METADATA_PATTERN.search(text.lstrip("\ufeff"))
    if not match:
        raise HookError("缺少 hook-library-index")
    try:
        metadata = json.loads(match.group("metadata"))
    except json.JSONDecodeError as exc:
        raise HookError(f"hook-library-index 不是有效 JSON:{exc}") from exc
    if not isinstance(metadata, dict):
        raise HookError("hook-library-index 必须是 JSON 对象")
    return metadata, text[: match.start()].rstrip()


def _required_string(metadata: dict[str, Any], key: str) -> str:
    value = metadata.get(key)
    if not isinstance(value, str) or not value.strip():
        raise HookError(f"缺少 {key}")
    return value.strip()


def _title(body: str) -> str:
    match = re.search(r"^# (.+?)\s*$", body, re.MULTILINE)
    if not match:
        raise HookError("缺少一级标题")
    return match.group(1).strip()


def _section(body: str, heading: str) -> str:
    match = re.search(rf"^## {re.escape(heading)}\s*$", body, re.MULTILINE)
    if not match:
        raise HookError(f"缺少“{heading}”")
    return body[match.end() :].strip()


def _hook_text(section: str) -> str:
    text = section.strip()
    if not text:
        raise HookError("钩子原文不能为空")
    if re.search(r"^来源:[^\r\n]+[ \t]*\Z", text, re.MULTILINE):
        raise HookError("钩子不保存来源字段")
    return text


def _parse_hook(path: Path, layout: LibraryLayout) -> HookExample:
    try:
        relative = path.relative_to(layout.hook_root)
    except ValueError as exc:
        raise HookError("钩子必须位于独立 Hook Library 目录") from exc
    if len(relative.parts) != 3 or relative.parts[0] != "Examples":
        raise HookError("钩子必须使用“Examples/写作技巧/文件”路径")
    metadata, body = _parse_metadata(path.read_text(encoding="utf-8-sig"))
    allowed = {"resource_type", "hook_id"}
    unknown = sorted(set(metadata) - allowed)
    if unknown:
        raise HookError("钩子元数据含有非寻址字段:" + "、".join(unknown))
    if metadata.get("resource_type") != "hook-example":
        raise HookError("resource_type 必须是 hook-example")
    technique = relative.parts[1]
    if technique not in SUPPORTED_TECHNIQUES:
        raise HookError(f"不支持的写作技巧:{technique}")
    hook_id = _required_string(metadata, "hook_id")
    if path.stem != hook_id:
        raise HookError("钩子文件名必须与 hook_id 一致,不能暴露题材或对象")
    text = _hook_text(_section(body, "钩子原文"))
    return HookExample(
        path=path,
        hook_id=hook_id,
        title=_title(body),
        technique=technique,
        text=text,
    )


def load_library(layout: LibraryLayout) -> tuple[list[HookExample], list[str]]:
    hooks: list[HookExample] = []
    issues: list[str] = []
    ids: dict[str, Path] = {}
    texts: dict[str, Path] = {}
    example_root = layout.hook_root / "Examples"
    paths = sorted(example_root.rglob("*.md")) if example_root.is_dir() else []
    for path in paths:
        try:
            hook = _parse_hook(path, layout)
            previous_id = ids.get(hook.hook_id)
            if previous_id is not None:
                raise HookError(f"hook_id 与 {previous_id} 重复")
            previous_text = texts.get(hook.text)
            if previous_text is not None:
                raise HookError(f"钩子原文与 {previous_text} 重复")
            ids[hook.hook_id] = path
            texts[hook.text] = path
            hooks.append(hook)
        except (HookError, OSError, UnicodeError) as exc:
            issues.append(f"{path}: {exc}")
    return hooks, issues


def build_index(hooks: Sequence[HookExample], layout: LibraryLayout) -> str:
    lines = [
        "# 钩子索引",
        "",
        "本索引包含全部钩子,不区分短内容、Thread 或文章,只按写作技巧分组。条目和文件名只显示不带题材含义的稳定编号;每个条目指向一份完整原文,索引不能替代原文。",
        "",
        f"当前共有 {len(hooks)} 条独立钩子。",
        "",
    ]
    for technique in TECHNIQUE_ORDER:
        group = [hook for hook in hooks if hook.technique == technique]
        if not group:
            continue
        lines.extend([f"## {technique}", ""])
        for hook in sorted(group, key=lambda item: item.hook_id):
            relative = Path(os.path.relpath(hook.path, layout.hook_root)).as_posix()
            lines.append(f"- [参考 {hook.hook_id}](<{relative}>)")
        lines.append("")
    return "\n".join(lines).rstrip() + "\n"


def write_indexes(
    layout: LibraryLayout,
    hooks: Sequence[HookExample],
    config_path: Path | None = None,
) -> Path:
    layout.hook_root.mkdir(parents=True, exist_ok=True)
    layout.hook_index.write_bytes(build_index(hooks, layout).encode("utf-8"))
    return layout.hook_index


def add_hook(
    layout: LibraryLayout,
    existing: Sequence[HookExample],
    *,
    input_path: Path,
    title: str,
    hook_id: str,
    technique: str,
    config_path: Path | None = None,
) -> Path:
    title = _safe_segment(title, "title")
    technique = _safe_segment(technique, "technique")
    if technique not in SUPPORTED_TECHNIQUES:
        raise HookError(f"不支持的写作技巧:{technique}")
    hook_id = hook_id.strip()
    if not hook_id:
        raise HookError("hook_id 不能为空")
    _safe_segment(hook_id, "hook_id")
    if any(item.hook_id == hook_id for item in existing):
        raise HookError(f"hook_id 已经存在:{hook_id}")
    try:
        text = input_path.read_text(encoding="utf-8-sig").strip()
    except FileNotFoundError as exc:
        raise HookError(f"输入文件不存在:{input_path}") from exc
    if not text:
        raise HookError("钩子原文不能为空")
    if any(item.text == text for item in existing):
        raise HookError("这份钩子原文已经存在")
    metadata = {
        "resource_type": "hook-example",
        "hook_id": hook_id,
    }
    path = layout.hook_root / "Examples" / technique / f"{hook_id}.md"
    if path.exists():
        raise HookError(f"钩子已经存在:{path}")
    body = "\n\n".join(
        [
            f"# {title}",
            "## 钩子原文",
            text,
            _metadata_block(metadata),
        ]
    ) + "\n"
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_bytes(body.encode("utf-8"))
    _parse_hook(path, layout)
    return path


def _parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="维护 100x Learning 独立钩子库")
    parser.add_argument("--library-root", type=Path, help="私人知识库根目录")
    parser.add_argument("--config", type=Path, help="本机私人库指针配置")
    commands = parser.add_subparsers(dest="command", required=True)
    commands.add_parser("validate", help="检查钩子原文与独立索引")
    index = commands.add_parser("build-index", help="重建或核对独立钩子索引")
    index.add_argument("--check", action="store_true")
    add = commands.add_parser("add-hook", help="从用户明确指定的独立原文建立钩子")
    add.add_argument("--input", type=Path, required=True)
    add.add_argument("--title", required=True)
    add.add_argument("--hook-id", required=True)
    add.add_argument("--technique", required=True, choices=TECHNIQUE_ORDER)
    return parser


def main(argv: list[str] | None = None) -> int:
    args = _parser().parse_args(argv)
    try:
        root = resolve_library_root(args.library_root, args.config)
        layout = validate_library(root)
        hooks, issues = load_library(layout)
        if issues:
            raise HookError("\n".join(issues))
        if args.command == "add-hook":
            created = add_hook(
                layout,
                hooks,
                input_path=args.input,
                title=args.title,
                hook_id=args.hook_id,
                technique=args.technique,
                config_path=args.config,
            )
            hooks, issues = load_library(layout)
            if issues:
                raise HookError("\n".join(issues))
            index_path = write_indexes(layout, hooks, args.config)
            print(f"钩子已保存:{created}\n索引已更新:{index_path}")
            return 0
        if args.command == "validate":
            expected = build_index(hooks, layout)
            if not layout.hook_index.is_file():
                raise HookError(f"钩子索引不存在:{layout.hook_index}")
            if layout.hook_index.read_text(encoding="utf-8") != expected:
                raise HookError(f"钩子索引需要更新:{layout.hook_index}")
            print(f"钩子库有效:{len(hooks)} 条;统一索引按写作技巧生成。")
            return 0
        if args.check:
            if not layout.hook_index.is_file():
                raise HookError(f"钩子索引不存在:{layout.hook_index}")
            if layout.hook_index.read_text(encoding="utf-8") != build_index(
                hooks, layout
            ):
                raise HookError(f"钩子索引需要更新:{layout.hook_index}")
            print("钩子统一索引有效")
            return 0
        index_path = write_indexes(layout, hooks, args.config)
        print(f"钩子索引已更新:{index_path}")
        return 0
    except (HookError, LibraryError, OSError, UnicodeError) as exc:
        print(str(exc), file=sys.stderr)
        return 1


if __name__ == "__main__":
    raise SystemExit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall