القائمة
Create or update local issues under docs/issues/; use when filing a gap out of scope for the current change.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/Apocrathia/homelab --skill file-issueيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Invoke homelab kagent agents through the LiteLLM A2A broker (list agents, send messages, stream, poll tasks). Use when delegating to git-agent, homelab-agent, hermes-agent, or other registered A2A peers — not via MCP.
Reconcile AGENTS.md and .agents/context/ against the repo: fix broken links, catalog drift, and routing mismatches. Use when asked to sync, reconcile, or update the agent context.
Close the docs/backlog side of a lap: fix behavior docs the change made wrong; delete satisfied issues/plans; fix backlinks. Use after implement, before draft-commit — not for AGENTS/.agents context drift.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | file-issue |
| description | Create or update local issues under docs/issues/; use when filing a gap out of scope for the current change. |
| disable-model-invocation | true |
Record a problem or desired state under docs/issues/.
Issues define what; plans define how. Plans live under
docs/plans/ (and optionally
.cursor/plans/ for IDE-only sessions) via
project-planner. Do not invent a
plan in the issue body.
Do not create GitLab issues unless the operator explicitly asks. Local
docs/issues/ is the default backlog.
Question channel when acceptance is fuzzy:
.agents/context/questions.md.
| Situation | Action |
|---|---|
| Fixable in the current change | Fix it — no issue |
| Out of scope for current change | File (or update duplicate) |
| Duplicate of an existing open issue | Update that file |
| Feature / spec / multi-path bug; acceptance unclear | alignment first, then file |
| Single intentional shortcut | ponytail: in code, not here |
Clustered ponytail: debt (a theme) | File one issue for the theme |
| Architecture friction | architecture-review then file (kind: architecture) |
- [ ] 1. Search docs/issues/*.md for duplicates (skip README, _template)
- [ ] 2. Duplicate → update that file; skip to step 5
- [ ] 3. Else copy docs/issues/_template.md → docs/issues/<short-slug>.md
- [ ] 4. Fill frontmatter + body (include Feedback loop)
- [ ] 5. Report the path to the operator
Template: docs/issues/_template.md.
Conventions: docs/issues/README.md.
Match docs/issues/_template.md:
| Field | Notes |
|---|---|
title | Short title |
kind | bug | feature | spec | architecture |
status | open | in-flight | blocked | closed | wontfix | superseded | promoted |
severity | blocker | high | medium | low |
source | e.g. agent | human | dogfood | review | alert | flux | ci |
found_at | YYYY-MM-DD |
found_by | Optional |
area | e.g. flux | helm | talos | observability | security | apps | networking | storage | agents |
slice | Optional: afk | hitl |
plan | Optional path (docs/plans/… preferred; .cursor/plans/… for IDE-only) |
gitlab | Optional URL when operator-promoted |
branch | Optional when in-flight |
Body must include Feedback loop (how to know acceptance is met without reading the full diff). Bugs: repro encouraged, not mandatory.
When acceptance is met, delete docs/issues/<slug>.md in the same change
set as the fix, and fix backlinks in linked plans/docs.
Closure is owned by reconcile-docs on the ship
path (or the parent/operator if that skill is not in play). Do not leave
satisfied issue files around.
draft-commit when authorized.kubectl apply, flux reconcile,
mutating MCP, etc.).