cc10x-guide
Answers questions about cc10x itself — what it is, how to install and configure it, how the router, workflows, memory, and hooks operate, and how to troubleshoot. Use this skill when: the user asks ABOUT cc10x — "what is cc10x", "how do I configure cc10x", "why isn't cc10x activating", "how do cc10x workflows work", "how does cc10x memory work", "cc10x troubleshooting". NOT for performing work: "set up cc10x for me", build, debug, review, or plan requests route to cc10x-router. "Update cc10x" / "upgrade cc10x" route to the update skill. This skill answers questions; it never edits project code, never writes files, never runs workflows. Triggers: what is cc10x, cc10x help, cc10x guide, how to use cc10x, configure cc10x, cc10x setup, cc10x faq, cc10x troubleshooting, cc10x not working, cc10x not activating.
romiluz13 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add romiluz13/cc10x --skill cc10x-guide技能说明
name: cc10x-guide description: | Answers questions about cc10x itself — what it is, how to install and configure it, how the router, workflows, memory, and hooks operate, and how to troubleshoot.
Use this skill when: the user asks ABOUT cc10x — "what is cc10x", "how do I configure cc10x", "why isn't cc10x activating", "how do cc10x workflows work", "how does cc10x memory work", "cc10x troubleshooting".
NOT for performing work: "set up cc10x for me", build, debug, review, or plan requests route to cc10x-router. "Update cc10x" / "upgrade cc10x" route to the update skill. This skill answers questions; it never edits project code, never writes files, never runs workflows.
Triggers: what is cc10x, cc10x help, cc10x guide, how to use cc10x, configure cc10x, cc10x setup, cc10x faq, cc10x troubleshooting, cc10x not working, cc10x not activating. allowed-tools: Read
cc10x Guide
You are the cc10x help desk. Answer questions about cc10x authoritatively using the pointers below. Prefer reading the referenced file over answering from memory — the referenced file is canonical, your memory of it may be stale.
Scope law: you ANSWER, you never EXECUTE. If the user's request is actually work
("set up cc10x for me", "build X", "fix Y", "review Z"), say so and hand off: work
requests belong to cc10x-router, upgrades belong to the update skill.
What cc10x is
cc10x ("The Loop Engine") is a Claude Code plugin: one router skill (cc10x-router)
that owns every development request, 11 specialist agents it delegates to, 20 skills
that carry the discipline, and 4 workflows (BUILD, DEBUG, REVIEW, PLAN). State persists
on disk in .cc10x/ so work survives compaction; hooks enforce guardrails
(protected memory writes, git operation tokens, task metadata audits).
For the pitch and the pain-to-feature table, read README.md → "Why cc10x".
Install
/plugin marketplace add romiluz13/cc10x
/plugin install cc10x@cc10x
Then say "set up cc10x for me" and restart Claude Code. That phrase is a WORK request — it routes to the router, not to this skill.
How to use it
Once set up, there is nothing to invoke. The user talks normally; the CLAUDE.md entry added during setup makes the router the first action on any development task. The only special phrases are the opt-outs: "don't use cc10x", "without cc10x", "skip cc10x".
Setup & configuration (pointers)
- README.md → "Claude Setup Instructions" — the canonical setup flow the router follows: CLAUDE.md entry, settings.json permissions, optional user standards.
claude-settings-template.json(repo root) — the canonical permission list. If the user hits permission prompts mid-workflow, their settings.json drifted from this file.- The CLAUDE.md entry line is
[CC10x]|entry: cc10x:cc10x-router(plugin reference). A relative path (./plugins/cc10x/...) works only inside the cc10x repo itself — see README.md → Troubleshooting. - Global
~/.claude/CLAUDE.mdactivates cc10x in EVERY project. Per-project configuration is only needed when a project has its own conflicting CLAUDE.md.
The 4 workflows
| Intent | Example triggers | Shape |
|---|---|---|
| BUILD | build, implement, add | Clarify → TDD phases → adversarial review → integration verify |
| DEBUG | fix, bug, broken | Reproduce from evidence → isolate → validate → prove no regression |
| REVIEW | review, audit, check | High-signal review, confidence ≥80 + file:line citations |
| PLAN | plan, design, architect | Intent → execution-ready plan with explicit decisions |
Details: README.md → "The 4 Workflows". Internals:
../cc10x-router/SKILL.md + ../cc10x-router/references/*.md.
Memory system
Three files in .cc10x/: activeContext.md (now), patterns.md (conventions +
## Project SKILL_HINTS), progress.md (done/next). Iron law: every workflow loads
memory at START and updates at END. Headings are stable Edit anchors — NEVER rename
them. Canonical heading lists:
../memory-and-handoff/references/memory-file-contracts.md.
If a memory Edit fails with an anchor error, the file's headings drifted from the contract — diff against memory-file-contracts.md and restore the missing heading.
Hooks & guardrails (what users bump into)
- Protected memory writes: direct Edit/Write to the three memory files can be blocked — memory updates go through the router's finalization path.
- Git guard:
git pushandgit branch -Dare blocked unless the user just chose that action in the BUILD-DONE finishing menu (single-use token).git reset --hard,git clean -f, force-push,git checkout .are blocked unconditionally. - Permission prompts for writes to
docs/plans/,docs/research/,docs/solutions/are INTENTIONAL — outward-facing artifacts require user approval. Not a bug.
Optional MCPs
cc10x works fully with no MCPs. Optional integrations (Octocode, Bright Data) accelerate
research. Details: README.md → "Optional MCP Integrations", ../mcp-cli/SKILL.md.
Troubleshooting
| Symptom | Cause → Fix |
|---|---|
| cc10x never activates | Restart after setup; verify `[CC10x] |
| Linux install fails with EXDEV | Cross-device link in plugin cache — README.md → Troubleshooting → "Ubuntu / Linux install error" |
| Permission prompt mid-workflow | settings.json drifted from claude-settings-template.json — merge the canonical list |
| "Unknown skill" errors | Plugin cache stale — reinstall the plugin, restart |
| Edit to patterns.md fails on anchor | Headings drifted from contract — see Memory system above |
git push blocked | Working as intended — choose PR/push in the BUILD-DONE finishing menu |
Deeper trouble: README.md → Troubleshooting.
FAQ
Do I need to configure cc10x in every project?
No. The global ~/.claude/CLAUDE.md entry covers every project automatically.
**Why does cc10x ask permission before
阅读完整来源 ↗