@sysmanager/sys-skills
Advanced tools
+1
-1
| { | ||
| "name": "@sysmanager/sys-skills", | ||
| "version": "1.0.17", | ||
| "version": "1.0.18", | ||
| "description": "Agent Skills Framework - Easy setup for AI agent capabilities and integrations (Claude, Gemini, Codex, GitHub Copilot)", | ||
@@ -5,0 +5,0 @@ "type": "module", |
@@ -237,3 +237,3 @@ --- | ||
| | 5b | **ADO Board custom states configurados** | States obrigatórios existem (ver 2.3) | Delegar `ado-board-manager validate-states` | | ||
| | 5c | **MCP Outline acessível** | OAuth válido OU `OUTLINE_API_KEY` no `.env` | Delegar `outline-wiki-manager read` | | ||
| | 5c | **MCP Outline acessível** | OAuth válido (sessão mantida pelo runtime — sem variável de ambiente) | Delegar `outline-wiki-manager read` | | ||
| | 5d | **Collection da wiki existe e está registrada** | `collection_id` em Rules + `.outline-sync.json` + responde em `collections.info` | Delegar `outline-wiki-manager read` | | ||
@@ -285,4 +285,3 @@ | 6 | **Estrutura de pastas do projeto** | `.agents/`, `specs/`, `steps/{research,plan,implement}/`, `<SKILLS_DIR>/` | `Test-Path` nos diretórios | | ||
| | Git CLI | `git-cli` | Universal | Operações git (commit, push, branch) | | ||
| | PRD Creator | `create-prd` | Research | Gerar PRD com workflow de perguntas | | ||
| | RFC Creator | `create-rfc` | Research, Plan | Propor mudanças e buscar alinhamento | | ||
| | PRD from Discovery | `prd-from-discovery` | Research, Plan | Gerar PRD e propor mudanças com workflow de perguntas e buscar alinhamento | | ||
| | ADR Creator | `create-adr` | Plan, Implement | Documentar decisões arquiteturais | | ||
@@ -323,14 +322,7 @@ | Technical Design Doc | `create-technical-design-doc` | Plan | Criar TDD com arquitetura, contratos | | ||
| **Pré-check: detectar modo de autenticação lendo `.mcp.json`:** | ||
| **Auth mode: OAuth** — `.mcp.json` configurado sem `headers`. Nenhuma variável de ambiente necessária; sessão mantida pelo runtime Claude Code após login via `/mcp`. | ||
| ``` | ||
| SE bloco outline em .mcp.json contém "headers.Authorization" | ||
| → modo API Key: verificar OUTLINE_API_KEY no .env (não-vazio, não commitado) | ||
| SENÃO | ||
| → modo OAuth: nenhuma variável de ambiente necessária; sessão mantida pelo runtime | ||
| ``` | ||
| **Validação (delegada ao `outline-wiki-manager read`):** | ||
| 1. Smoke `collections.list` retorna 200 | ||
| 2. Auth OK conforme modo detectado acima | ||
| 2. OAuth válido (se 401 → `/mcp` no Claude Code para renovar sessão) | ||
| 3. `collection_id` registrado em `config.yaml` existe via `collections.info` | ||
@@ -337,0 +329,0 @@ 4. `collection_url` registrada em `config.yaml` e em `.outline-sync.json` |
@@ -85,3 +85,3 @@ --- | ||
| | P4 | Pasta `specs/` criada | Para specs por épico | | ||
| | P5 | Skills de Plan instaladas | `ado-workflow`, `create-rfc`, `create-adr`, `create-technical-design-doc`, `generate-tasks`, `git-cli` no diretório do target | | ||
| | P5 | Skills de Plan instaladas | `ado-workflow`, `prd-from-discovery`, `create-adr`, `create-technical-design-doc`, `generate-tasks`, `git-cli` no diretório do target | | ||
| | P6 | Worktrees planejados | Um por épico paralelizável do `parallelism-map.md` | | ||
@@ -88,0 +88,0 @@ | P7 | **PRD + Design Doc publicados na wiki** | URLs registrados em `.outline-sync.json` (`mappings.prd`, `mappings.design-doc`); docs existem. Delegar `outline-wiki-manager read` | |
@@ -103,4 +103,3 @@ --- | ||
| │ │ ├── git-cli/SKILL.md | ||
| │ │ ├── create-prd/SKILL.md | ||
| │ │ ├── create-rfc/SKILL.md | ||
| │ │ ├── prd-from-discovery/SKILL.md | ||
| │ │ └── ado-workflow/SKILL.md | ||
@@ -350,4 +349,3 @@ │ ├── workflows/ | ||
| npx @sysmanager/sys-skills install --skill git-cli | ||
| npx @sysmanager/sys-skills install --skill create-prd | ||
| npx @sysmanager/sys-skills install --skill create-rfc | ||
| npx @sysmanager/sys-skills install --skill prd-from-discovery | ||
| ``` | ||
@@ -623,3 +621,3 @@ | ||
| | R6 | Template `discovery.md` disponível | Schema dos 5 blocos | | ||
| | R7 | Skills `create-prd`, `create-rfc` instaladas | Verificar diretório do target | | ||
| | R7 | Skill `prd-from-discovery` instalada | Verificar diretório do target | | ||
| | R8 | **Work items âncora no ADO** | Epic + WIT SDLC existem e estão vinculados (ver 0.5.1) | | ||
@@ -626,0 +624,0 @@ | R9 | **Sub-collection Research preparada na wiki** | `phases.research` em `.outline-sync.json` preenchido (não-null); `parent_doc_id` e todos `steps.E0–E6.doc_id` existem. Delegar `outline-wiki-manager read` | |
@@ -17,4 +17,3 @@ --- | ||
| env: [] | ||
| env_optional: | ||
| OUTLINE_API_KEY: "Apenas se auth via API Key. OAuth não requer variável de ambiente." | ||
| env_optional: {} | ||
| tags: [outline, wiki, documentation, templates, sync, audit] | ||
@@ -46,4 +45,3 @@ --- | ||
| | **Endpoint self-hosted** | `https://<seu-dominio>/mcp` | | ||
| | **Auth padrão** | OAuth (login interativo no browser) | | ||
| | **Auth alternativa** | API Key via header `Authorization: Bearer <api-key>` | | ||
| | **Auth** | OAuth (login interativo no browser via `/mcp`) | | ||
| | **Disponibilidade** | Cloud-hosted: já disponível • Self-hosted: Outline ≥ v1.6.0 | | ||
@@ -56,13 +54,12 @@ | ||
| 3. **Cliente MCP que suporta HTTP transport** (Claude Code, Claude Desktop, Cursor, VS Code/Copilot recentes, Codex CLI) | ||
| 4. **`OUTLINE_API_KEY` no `.env`** — **somente se** autenticando via API Key. OAuth não requer nenhuma variável de ambiente — a sessão é mantida pelo runtime do cliente MCP após o login interativo (`/mcp` no Claude Code). | ||
| ### Setup do MCP por cliente | ||
| **Claude Code (CLI) — OAuth (padrão, sem API Key):** | ||
| **Claude Code (CLI) — OAuth:** | ||
| ```bash | ||
| claude mcp add --transport http outline https://<subdomain>.getoutline.com/mcp | ||
| ``` | ||
| Dentro do Claude Code, rodar `/mcp` e seguir o fluxo OAuth (login no browser). Nenhuma variável de ambiente necessária. | ||
| Rodar `/mcp` dentro do Claude Code e seguir o fluxo OAuth (login no browser). Nenhuma variável de ambiente necessária. | ||
| Config resultante em `.mcp.json` (sem headers — OAuth gerenciado pelo runtime): | ||
| Config resultante em `.mcp.json`: | ||
| ```json | ||
@@ -79,18 +76,2 @@ { | ||
| **Claude Code (CLI) — API Key (alternativa quando OAuth não for viável):** | ||
| Acrescentar `headers` ao bloco outline em `.mcp.json` e definir `OUTLINE_API_KEY` no `.env` (não commitar): | ||
| ```json | ||
| { | ||
| "mcpServers": { | ||
| "outline": { | ||
| "type": "http", | ||
| "url": "https://<subdomain>.getoutline.com/mcp", | ||
| "headers": { | ||
| "Authorization": "Bearer ${OUTLINE_API_KEY}" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
| **Claude Desktop:** | ||
@@ -121,3 +102,2 @@ Settings → Connectors → Add Connector → URL: `https://<subdomain>.getoutline.com/mcp` → OAuth interativo. | ||
| ``` | ||
| Para API Key em vez de OAuth, acrescentar `"headers": { "Authorization": "Bearer ${input:outline-api-key}" }` e definir o `input`. | ||
@@ -129,4 +109,3 @@ **Codex CLI (`~/.codex/config.toml`):** | ||
| url = "https://<subdomain>.getoutline.com/mcp" | ||
| # Auth via OAuth ao primeiro acesso. Para API Key, descomente: | ||
| # headers = { Authorization = "Bearer ${OUTLINE_API_KEY}" } | ||
| # Auth via OAuth ao primeiro acesso. | ||
| ``` | ||
@@ -500,3 +479,3 @@ | ||
| 1. **Confirmar antes de operações destrutivas** — delete, batch delete, replace de conteúdo grande | ||
| 2. **Nunca expor `OUTLINE_API_KEY`** — somente relevante no modo API Key; não logar, não printar, não inserir em commit. No modo OAuth, nenhum secret existe para expor. | ||
| 2. **Nunca logar tokens OAuth** — a sessão é gerenciada pelo runtime; não reproduzir cookies ou tokens de sessão em logs ou commits. | ||
| 3. **Modo read-only quando em dúvida** — se variável `OUTLINE_READ_ONLY` está setada, respeitar e bloquear writes | ||
@@ -503,0 +482,0 @@ 4. **Sempre listar antes de batch** — mostrar lista completa de afetados ao usuário |
Filesystem access
Supply chain riskAccesses the file system, and could potentially read sensitive data.
Found 1 instance in 1 package
Filesystem access
Supply chain riskAccesses the file system, and could potentially read sensitive data.
Found 1 instance in 1 package
605784
-0.22%