pm-skill 1.1.5 → 1.1.6

package/AGENTS.md

@@ -6,6 +6,12 @@ This file provides instructions for AI coding assistants (Codex, Claude Code, et
 
 A structured project management CLI that integrates Linear (issue tracking) and Notion (documentation). It enforces a config-driven workflow where only pre-defined labels, templates, and severity levels are allowed.
 
+## Rules
+
+- If the user writes `/pm-skill <args>`, execute `npx pm-skill <args>` from the project root.
+- When the user mentions pm-skill, Linear issues, or Notion documents, prefer using pm-skill commands.
+- This tool requires shell execution and network access (Linear/Notion APIs).
+
 ## Prerequisites
 
 - Node.js 18 or higher (`node --version` to check)

package/SKILL.md

@@ -1,8 +1,20 @@
+---
+name: pm-skill
+description: Structured project management CLI — Linear + Notion integration. Trigger on: pm-skill, Linear issue, Notion doc, start-feature, report-bug, push-doc, backlog
+---
+
 # PM Skill — Structured Project Management
 
 Linear + Notion integration for structured project management.
 "Design freedom, usage discipline" — only labels/templates/severity defined in `config.yml` are allowed.
 
+## Rules
+
+- When the user mentions **pm-skill**, **Linear issue**, **Notion document**, **start-feature**, **report-bug**, **backlog**, or **push-doc**, use this skill.
+- If the user writes `/pm-skill <args>`, execute `npx pm-skill <args>` from the project root.
+- This skill requires **shell execution** and **network access** (Linear/Notion APIs).
+- If `.env` does not exist, run `npx pm-skill init` first.
+
 ## Prerequisites
 
 Requires Node.js 18+. If `.env` does not exist in the project, run `init` first.
@@ -18,6 +30,9 @@ npx pm-skill setup
 
 # Create missing labels in Linear
 npx pm-skill setup --sync
+
+# Install as Codex global skill (optional)
+npx pm-skill install-codex-skill
 ```
 
 ## Commands
@@ -28,8 +43,15 @@ Verify Linear/Notion connection + label matching. `--sync` creates missing label
 npx pm-skill setup
 ```
 
+### select-project / select-page
+Switch active Linear project or Notion root page.
+```bash
+npx pm-skill select-project "Project Name"
+npx pm-skill select-page "Page Name"
+```
+
 ### start-feature
-Start feature development. Creates Linear issue + Notion PRD + bidirectional links.
+Start feature development. Creates Linear issue with task checklist.
 ```bash
 npx pm-skill start-feature "Feature title"
 ```
@@ -47,20 +69,41 @@ Add sub-task to an issue.
 npx pm-skill add-task ENG-10 "Write unit tests"
 ```
 
-### relate
-Link two issues. (related, similar)
+### relate / block
+Link or set blocking relationship between issues.
 ```bash
 npx pm-skill relate ENG-10 ENG-11 --type related
+npx pm-skill block ENG-10 ENG-11
 ```
 
-### block
-Set blocking relationship. (ENG-10 must complete before ENG-11)
+### push-doc
+Upload markdown to Notion. Optionally link to a Linear issue.
 ```bash
-npx pm-skill block ENG-10 ENG-11
+# From file
+npx pm-skill push-doc ./design.md --title "Design Doc" --issue ENG-10
+
+# From content (AI agent use case)
+npx pm-skill push-doc --title "Report" --content "# Results..." --issue ENG-10
+
+# Under a specific parent page
+npx pm-skill push-doc ./schema.md --parent <page-id>
+```
+
+### update-doc
+Replace existing Notion page content with new markdown.
+```bash
+npx pm-skill update-doc <page-id> ./updated.md
+npx pm-skill update-doc <page-id> --content "# Updated..."
+```
+
+### create-folder
+Create Notion page as a category/folder.
+```bash
+npx pm-skill create-folder "Schema Docs" --parent <page-id>
 ```
 
 ### attach-doc
-Attach document URL to issue. Type is validated against config.
+Attach a document URL to an issue with type validation.
 ```bash
 npx pm-skill attach-doc ENG-10 \
   --url "https://notion.so/..." \
@@ -75,6 +118,13 @@ Show issue details including sub-issues, relations, and attachments.
 npx pm-skill get ENG-10
 ```
 
+### delete
+Delete issue(s) and linked Notion pages.
+```bash
+npx pm-skill delete ENG-10
+npx pm-skill delete ENG-10 --recursive   # also delete sub-issues
+```
+
 ## Workflow Examples
 
 ### Feature Development
@@ -82,9 +132,8 @@ npx pm-skill get ENG-10
 npx pm-skill start-feature "Booking cancellation"
 npx pm-skill add-task ENG-10 "API endpoint"
 npx pm-skill add-task ENG-10 "Frontend UI"
-npx pm-skill add-task ENG-10 "Tests"
+npx pm-skill push-doc ./design.md --issue ENG-10
 npx pm-skill relate ENG-10 ENG-8 --type related
-npx pm-skill block ENG-10 ENG-15
 ```
 
 ### Bug Fix
@@ -94,13 +143,9 @@ npx pm-skill add-task ENG-20 "Root cause analysis"
 npx pm-skill add-task ENG-20 "Fix and test"
 ```
 
-## Config
-
-| Section | Description |
-|---------|-------------|
-| `labels` | Available labels (description required) |
-| `templates` | Command → label/priority/Notion template mappings |
-| `priorities` | p0-p3 → Linear priority mapping |
-| `severity_mapping` | severity name → priority key |
-| `doc_types` | Document types for attach-doc |
-| `epics` | Epic definitions |
+### Document Management
+```bash
+npx pm-skill create-folder "Schema Docs"
+npx pm-skill push-doc ./schema.md --parent <folder-id>
+npx pm-skill update-doc <page-id> ./schema-v2.md
+```

package/config.yml

@@ -19,15 +19,6 @@ labels:
     name: Refactor
     description: "기존 코드 리팩토링 (기능 변경 없음)"
     color: "#888888"
-  - id: admin
-    name: Admin
-    description: "인프라, 배포, 환경 설정 등 관리 작업"
-    color: "#ffaa00"
-  - id: guest
-    name: Guest
-    description: "외부 의존성, 서드파티 연동 관련"
-    color: "#aa88ff"
-
 templates:
   - id: feature
     name: Feature

package/dist/workflows.js

@@ -613,6 +613,14 @@ async function selectPage(args) {
         console.log(`\nUsage: npx pm-skill select-page "<name or id>"`);
     }
 }
+async function installCodexSkill() {
+    const { homedir } = await import("os");
+    const targetDir = resolve(homedir(), ".codex", "skills", "pm-skill");
+    const targetPath = resolve(targetDir, "SKILL.md");
+    copyBundledFile("SKILL.md", targetPath);
+    console.log(`\n✅ Codex skill installed: ${targetPath}`);
+    console.log(`   Restart Codex to pick up the new skill.`);
+}
 // ── Command Registry ──
 const COMMANDS = {
     setup: (ctx, args) => setup(ctx, args),
@@ -654,6 +662,7 @@ Commands:
   setup [--sync]                     Verify config & label matching (--sync creates missing labels)
   select-project [name-or-id]        List or switch Linear project
   select-page [name-or-id]           List or switch Notion root page
+  install-codex-skill                Install skill to ~/.codex/skills/ for Codex
   start-feature <title>              Start feature (Linear issue with task checklist)
   report-bug <title> [--severity S]  File bug report (severity: urgent/high/medium/low)
   add-task <parent> <title>          Add sub-task to an issue
@@ -691,6 +700,10 @@ All config is per-project (CWD). Run 'npx pm-skill init' in each project.`);
         await selectPage(args);
         return;
     }
+    if (command === "install-codex-skill") {
+        await installCodexSkill();
+        return;
+    }
     const cmdFn = COMMANDS[command];
     if (!cmdFn) {
         const available = ["init", ...Object.keys(COMMANDS)].join(", ");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-skill",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Structured project management CLI — Linear + Notion integration for AI coding assistants (Claude Code, Codex)",
   "type": "module",
   "bin": {