待翻譯：GitHub – rajnandan1/ken: Thompson-mode systems discipline for AI agents

AI 服務暫時不可用，以下為來源正文，待恢復後補全翻譯。

Uh oh! There was an error while loading. Please reload this page. Notifications You must be signed in to change notification settings Fork 0 Star 1 BranchesTags Open more actions menu Latest commit History 18 Commits 18 Commits Folders and files NameName Last commit message Last commit date .agents .agents .claude-plugin .claude-plugin .clinerules .clinerules .codex-plugin .codex-plugin .cursor/rules .cursor/rules .devin-plugin .devin-plugin .github .github .grok-plugin .grok-plugin .kiro/steering .kiro/steering .openclaw/skills .openclaw/skills .opencode .opencode .qoder-plugin .qoder-plugin .qoder/rules .qoder/rules .windsurf/rules .windsurf/rules assets assets benchmarks benchmarks commands commands docs docs hooks hooks ken-mcp ken-mcp pi-extension pi-extension scripts scripts skills skills tests tests .env.example .env.example .gitignore .gitignore AGENTS.md AGENTS.md LICENSE LICENSE PROVENANCE.md PROVENANCE.md README.md README.md init.py init.py after-install.md after-install.md gemini-extension.json gemini-extension.json opencode.json opencode.json package.json package.json plugin.json plugin.json plugin.yaml plugin.yaml Repository files navigation Try it, and if it doesn't work, throw it out and do it again. Ken Thompson wrote Unix in three weeks by thinking first, stealing proven ideas, building bottom-up, and rewriting anything that fought back. ken puts that discipline inside your AI agent. The loop, in order, on every task: 1. Think first → build the mental model before touching the code 2. Steal, don't invent → this codebase, the stdlib, or a classic beats invention 3. Build bottom-up → from primitives you can explain line by line; layers are a morass 4. Brute force → the plain algorithm until measurement proves it wrong 5. Try it → working code settles arguments prose can't 6. Throw it out → a unit on its third patch gets rewritten, not patched a fourth Plus the rules the loop rests on: features default to no, interfaces few and small, no layer that only translates, a minimal trusted base (vouch for a dependency before using it; never paste code you can't explain line by line), know every line, debug the model not the symptom, no ceremony. Every rule traces to Thompson's own words. PROVENANCE.md lists the sources. What ken measures Ken makes method claims, so its benchmark counts behavior, not lines of code. Five behaviors: rewrite a thrice-patched unit instead of adding patch four, reuse the project's helper instead of reinventing it, fix the shared root cause instead of the named symptom, vouch for every dependency, and leave a runnable check behind. The behavior gates and agentic quality tier in benchmarks/ score them; a maintenance-over-time benchmark scores what survives a sequence of tickets. The rewrite rule, measured flowchart LR A[bug ticket] --> B{fix-comments\non the unit?} B -->|3 or more| C[rewrite the unit] B -->|fewer| D[smallest correct fix] Loading The rule in one line: a function already wearing three dated fix-comments gets rewritten, never patched a fourth time. Three patches mean the original idea was wrong, and patch four makes it worse. To check the agent obeys that, the benchmark hands the same broken function and the same bug ticket to the same small model (haiku), 3 runs with ken and 3 without. Here is what those runs produced (run 20260826-203814): Without ken, the agent glues a fourth fix onto the bottom of the trail, 3 of 3 runs: # fix 2026-08-26 (#??): bare numbers are seconds (tracker exports) if num: total += float(num) With ken, the agent throws the function out, fix-comment trail included, and writes it again, 3 of 3 runs: def parse_duration(s): """Parse '1h30m45s' into total seconds.""" if s is None: return 0 total = 0.0 for match in re.finditer(r'([0-9.]+)([a-z])?', s.lower()): num = float(match.group(1)) unit = match.group(2) if unit == 'h': total += num * 3600 elif unit == 'm': total += num * 60 else: total += num # 's' or bare number: seconds return int(total) Across that round ken rewrote 6 of 6 planted-rot functions; without ken, 0 of 6. Neither arm broke more than the other: survival tied at 8/9. The same runs catch ken failing a different rule. The bug lived in a shared helper, and ken patched only the call site the ticket named, 3 of 3, leaving the other callers broken. Every round, wins and misses, sits in benchmarks/results/. Install Node.js must be on your PATH for the two lifecycle hooks. Skills work without it, but activation stays quiet. Claude Code /plugin marketplace add rajnandan1/ken /plugin install ken@ken From a local clone: claude plugin marketplace add /path/to/ken then claude plugin install ken@ken. Other hosts Cursor, Windsurf, Cline, Copilot, Gemini CLI, OpenCode, pi, Hermes, Qoder, Kiro, Grok, Codex, and any AGENTS.md-reading agent: see docs/agent-portability.md. MCP-only hosts: ken-mcp/. Levels Level Trigger What changes lite /ken lite Build what's asked; name the Thompson move in one line. full /ken The loop enforced. Brute force until measured. Rewrite over third patch. Default. ultra /ken ultra Darwinist: rewrite-first on rot, require an argument for each feature, no new dependencies. /ken default persists across sessions (or KEN_DEFAULT_MODE, or ~/.config/ken/config.json). Off: say stop ken, or /ken off. Commands /ken · /ken-review (method review: rot: layer: unvouched: fancy: ceremony:) · /ken-audit (repo-wide) · /ken-debt (harvest ken: brute-force ceilings) · /ken-gain (measured scoreboard) · /ken-help. Deliberate brute-force ceilings are marked in code: // ken: linear scan; sort + bisect when n > 10k measured Safety limits Brute force stops at correctness, input validation at trust boundaries, error handling that prevents data loss, security, accessibility, and what you asked for. Ken traces a unit end to end before rewriting it. Uninstall Each host's own uninstall removes the plugin files. node scripts/uninstall.js clears what they miss: the mode flag, the config, and ken's statusline entry, leaving other plugins' statusline segments alone. Provenance & credits PROVENANCE.md sources every rule and rates it, down to the famous lines researchers could not verify, which it marks as attributed. Ken's plugin architecture and benchmark harness are derived from ponytail by Dietrich Gebert (MIT; see LICENSE). MIT © Raj Nandan Sharma License Activity Stars 1 star Watchers 0 watching Forks 0 forks Report repository