菜单
Keep documentation aligned with runtime behavior. Use when: changing ports, entry points, startup commands, env variables, service responsibilities, or removing/renaming scripts. Requires a runtime-vs-docs comparison before finalizing any change that alters observable behavior.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | docs-drift-sync |
| description | Keep documentation aligned with runtime behavior. Use when: changing ports, entry points, startup commands, env variables, service responsibilities, or removing/renaming scripts. Requires a runtime-vs-docs comparison before finalizing any change that alters observable behavior. |
The main README.md is the single source of truth. When it conflicts with other docs, main README wins.
| Fact | Authoritative file | Stale copies to check |
|---|---|---|
| Service ports | README.md service table | app/scripts/README.md, .claude/skills/repo-guidelines/AGENTS.md, .github/copilot-instructions.md, services/chatbot/.env*, Docker compose files |
| Entry points | README.md service table | .claude/skills/repo-guidelines/AGENTS.md, .github/copilot-instructions.md, startup scripts in app/scripts/ |
| Env variable names | services/chatbot/core/config.py | README.md, .env.example, app/config/.env*, .claude/skills/repo-guidelines/AGENTS.md |
| MCP transport | services/mcp-server/server.py (stdio) | services/mcp-server/README.md, app/scripts/README.md (stale port 8000) |
| Startup commands | services/chatbot/run.py | README.md, app/scripts/README.md |
| Dependency profiles | app/requirements/*.txt | app/requirements/README.md, .claude/skills/repo-guidelines/AGENTS.md |
| Test commands | .github/workflows/tests.yml | README.md, .claude/skills/repo-guidelines/AGENTS.md |
| Location | Claim | Correct value |
|---|---|---|
app/scripts/README.md | Stable Diffusion = 7860 | 7861 |
app/scripts/README.md | Edit Image = 7861 | 8100 |
app/scripts/README.md | MCP Server = 8000 (HTTP) | stdio (no port) |
app/scripts/README.md | speech2text (5001), text2sql (5002) | Archived — no longer in services/ |
app/requirements/README.md | Lists hub-gateway, speech2text, text2sql, document-intelligence | Only chatbot + mcp-server are active core services |
| Trigger | Docs to update |
|---|---|
| Port changed (code or env default) | README.md service table, .claude/skills/repo-guidelines/AGENTS.md, .github/copilot-instructions.md, affected .env* files |
| Entry point changed | README.md, .claude/skills/repo-guidelines/AGENTS.md |
| New env variable added | core/config.py, README.md env table, .env.example |
| Env variable renamed/removed | Same as above plus search all .env* and .instructions.md files |
| New route added | Route docstring; README.md if user-facing |
| Service added or removed | README.md service table, .claude/skills/repo-guidelines/AGENTS.md, .github/copilot-instructions.md, app/requirements/README.md |
| Startup command changed | README.md quick-start section, affected script files |
| MCP tool added/changed | services/mcp-server/README.md |
| Workflow changed | No doc update unless it changes user-visible behavior |
Before marking a behavioral change as complete, run this comparison:
Ordered by frequency of drift:
app/scripts/README.md — highest drift risk, multiple stale entries already.claude/skills/repo-guidelines/AGENTS.md — duplicates the service table.github/copilot-instructions.md — duplicates ports and entry pointsservices/chatbot/.env* — port defaults may diverge from code defaultsapp/requirements/README.md — lists archived servicesapp/config/After any change that alters runtime behavior:
README.md service table matches runtime (ports, entry points, transport)..claude/skills/repo-guidelines/AGENTS.md service map matches README.md..github/copilot-instructions.md entry-point table matches README.md.app/scripts/README.md.core/config.py, .env.example, and README.md are aligned.Bridge the ComfyUI anime image pipeline into the chat SSE stream so image generation renders inline in the chat bubble. Use when: changing how image-generation events reach the chat UI, editing the force_image_bridge gate or the SSE forwarder in stream.py, touching cancel / GPU-leak handling (GeneratorExit → request_cancel → /free), the error_class taxonomy, the Phase 1b thinking-block nesting, or the Phase 3 WS live-preview; debugging why an image turn stalls, double-renders, leaks VRAM, or shows the wrong error; or running the PR4 verification harness. This subsystem deliberately spans services/chatbot/ AND app/image_pipeline/.
Choose which repository skill to activate for a given task. Use when: starting any chatbot, MCP, config, or docs task to determine the best skill or skill combination; reviewing whether the right skills were applied; or deciding whether to combine multiple skills for a cross-cutting change.
Repository maintenance and coding-agent instructions for AI-Assistant.
Reason about the impact of chatbot/core changes on GitHub workflows, tests, security scans, and CI behavior. Use when: adding or changing routes, tools, providers, or dependencies; reviewing a PR that might affect CI; debugging CI failures after a chatbot change; checking whether a code change needs a workflow or docs update; or auditing workflow assumptions after startup or env changes.
Map changed files to the smallest sufficient verification set. Use when: deciding which tests to run after a code change, explaining why a test scope is enough, or choosing between unit tests, integration tests, and manual checks.
Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: "Index this repo", "Reanalyze the codebase", "Generate a wiki"