@kodax-ai/kodax 0.7.95 → 0.7.96-alpha.2

package/config-templates/integrations/a2a.example.jsonc

@@ -1,71 +1,71 @@
-// Bidirectional A2A configuration: ~/.kodax/integrations/a2a.json.
-// `agents` calls many third-party Agents. The optional singleton `server`
-// exposes exactly one KodaX general task Agent; ACP remains the coding/editor
-// protocol. Uncomment only the entries you need; no token value belongs here.
-// Legacy version 1 files remain readable. Non-empty files require an explicit
-// stopped-daemon migration; new/empty files and every later write use version 2.
-{
-  "version": 2,
-
-  // Create this inbound block with `kodax a2a expose`; config never starts a
-  // listener by itself. Do not copy private Agent instructions, Runtime Skills,
-  // model names, or local paths into the public `published.skills` list.
-  // Managed workspaces default below
-  // ~/kodax_a2a_server_workspace/<runtime-profile>/contexts/<context-key>/.
-  // Native read/grep/glob remains available according to workspace access.
-  // Arbitrary shell is never exposed. Skill instructions/assets need no
-  // process authority. An exact checked-in scripts/... entry requires
-  // process="isolated", skillScripts admission, and `kodax sandbox doctor`.
-  // ASRT receives no KodaX credentials or ambient ~/.srt-settings.json and its
-  // script quota is observed; hostile tenants also require an outer container/VM.
-  //
-  // "server": {
-  //   "execution": {
-  //     "kind": "local-agent",
-  //     "agentRef": { "source": "markdown:user", "name": "report-agent" },
-  //     "workspace": { "mode": "managed" },
-  //     "toolPolicy": {
-  //       "workspace": "write",
-  //       "process": "deny",
-  //       "network": { "mode": "deny" },
-  //       "tools": [],
-  //       "mcp": {},
-  //       "skillScripts": {},
-  //       "subagents": "deny"
-  //     }
-  //   },
-  //   "published": {
-  //     "name": "KodaX Agent",
-  //     "description": "Completes approved general tasks.",
-  //     "version": "0.7.71",
-  //     "skills": [{ "id": "general", "name": "General", "description": "Complete general tasks.", "tags": [] }],
-  //     "inputModes": ["text/plain"],
-  //     "outputModes": ["text/plain"]
-  //   },
-  //   "authentication": { "type": "bearer-env", "tokenEnv": "KODAX_A2A_TOKEN", "principalId": "configured-client" },
-  //   "dataDir": "~/.kodax/a2a/tasks"
-  // },
-
-  // Production OAuth2 resource-server alternative for the server above. The
-  // external Authorization Server issues access tokens and, for JWT tokens,
-  // signs them. KodaX holds no issuer signing key; it validates RFC 9068 tokens
-  // against the issuer's rotating JWKS, audience, expiry, subject, and scopes.
-  // Replace the server.authentication value above with:
-  // {
-  //   "type": "oauth2-jwt",
-  //   "scheme": "enterprise-oauth",
-  //   "issuer": "https://identity.example.com",
-  //   "audience": "https://agent.example.com/a2a",
-  //   "jwksUrl": "https://identity.example.com/.well-known/jwks.json",
-  //   "tokenUrl": "https://identity.example.com/oauth/token",
-  //   "metadataUrl": "https://identity.example.com/.well-known/oauth-authorization-server",
-  //   "requiredScopes": ["a2a.invoke"]
-  // }
-
-  "agents": {
-    // Fixed Bearer compatibility example. `enabled` is hot desired state:
-    // disabled Agents remain configured but are not candidates for new
-    // orchestration, while already admitted remote tasks may finish.
+// Bidirectional A2A configuration: ~/.kodax/integrations/a2a.json.
+// `agents` calls many third-party Agents. The optional singleton `server`
+// exposes exactly one KodaX general task Agent; ACP remains the coding/editor
+// protocol. Uncomment only the entries you need; no token value belongs here.
+// Legacy version 1 files remain readable. Non-empty files require an explicit
+// stopped-daemon migration; new/empty files and every later write use version 2.
+{
+  "version": 2,
+
+  // Create this inbound block with `kodax a2a expose`; config never starts a
+  // listener by itself. Do not copy private Agent instructions, Runtime Skills,
+  // model names, or local paths into the public `published.skills` list.
+  // Managed workspaces default below
+  // ~/kodax_a2a_server_workspace/<runtime-profile>/contexts/<context-key>/.
+  // Native read/grep/glob remains available according to workspace access.
+  // Arbitrary shell is never exposed. Skill instructions/assets need no
+  // process authority. An exact checked-in scripts/... entry requires
+  // process="isolated", skillScripts admission, and `kodax sandbox doctor`.
+  // ASRT receives no KodaX credentials or ambient ~/.srt-settings.json and its
+  // script quota is observed; hostile tenants also require an outer container/VM.
+  //
+  // "server": {
+  //   "execution": {
+  //     "kind": "local-agent",
+  //     "agentRef": { "source": "markdown:user", "name": "report-agent" },
+  //     "workspace": { "mode": "managed" },
+  //     "toolPolicy": {
+  //       "workspace": "write",
+  //       "process": "deny",
+  //       "network": { "mode": "deny" },
+  //       "tools": [],
+  //       "mcp": {},
+  //       "skillScripts": {},
+  //       "subagents": "deny"
+  //     }
+  //   },
+  //   "published": {
+  //     "name": "KodaX Agent",
+  //     "description": "Completes approved general tasks.",
+  //     "version": "0.7.71",
+  //     "skills": [{ "id": "general", "name": "General", "description": "Complete general tasks.", "tags": [] }],
+  //     "inputModes": ["text/plain"],
+  //     "outputModes": ["text/plain"]
+  //   },
+  //   "authentication": { "type": "bearer-env", "tokenEnv": "KODAX_A2A_TOKEN", "principalId": "configured-client" },
+  //   "dataDir": "~/.kodax/a2a/tasks"
+  // },
+
+  // Production OAuth2 resource-server alternative for the server above. The
+  // external Authorization Server issues access tokens and, for JWT tokens,
+  // signs them. KodaX holds no issuer signing key; it validates RFC 9068 tokens
+  // against the issuer's rotating JWKS, audience, expiry, subject, and scopes.
+  // Replace the server.authentication value above with:
+  // {
+  //   "type": "oauth2-jwt",
+  //   "scheme": "enterprise-oauth",
+  //   "issuer": "https://identity.example.com",
+  //   "audience": "https://agent.example.com/a2a",
+  //   "jwksUrl": "https://identity.example.com/.well-known/jwks.json",
+  //   "tokenUrl": "https://identity.example.com/oauth/token",
+  //   "metadataUrl": "https://identity.example.com/.well-known/oauth-authorization-server",
+  //   "requiredScopes": ["a2a.invoke"]
+  // }
+
+  "agents": {
+    // Fixed Bearer compatibility example. `enabled` is hot desired state:
+    // disabled Agents remain configured but are not candidates for new
+    // orchestration, while already admitted remote tasks may finish.
     // "reporting": {
     //   "cardUrl": "https://agents.example.com/.well-known/agent-card.json",
     //   "enabled": true,
@@ -89,26 +89,26 @@
     //   "effect": "read"
     // },
 
-    // Standards-based machine-to-machine OAuth2 example. The external
-    // Authorization Server issues access tokens; KodaX obtains and caches them
-    // only in process memory. `tokenUrl` must exactly match the selected Card
-    // OAuth2 clientCredentials flow. Use `kodax a2a enable|disable <name>` to
-    // mutate `enabled` atomically; the owning Runtime applies it asynchronously.
-    // "reviewer": {
-    //   "cardUrl": "https://reviewer.example.com/.well-known/agent-card.json",
-    //   "enabled": false,
-    //   "effect": "read",
-    //   "authentication": {
-    //     "type": "oauth2-client-credentials",
-    //     "scheme": "enterprise-oauth",
-    //     "issuer": "https://identity.example.com",
-    //     "tokenUrl": "https://identity.example.com/oauth/token",
-    //     "clientId": "kodax-reviewer",
-    //     "clientSecretEnv": "REVIEWER_CLIENT_SECRET",
-    //     "scopes": ["a2a.invoke"],
-    //     "resource": "https://reviewer.example.com/",
-    //     "clientAuthentication": "client-secret-basic"
-    //   }
-    // }
-  }
-}
+    // Standards-based machine-to-machine OAuth2 example. The external
+    // Authorization Server issues access tokens; KodaX obtains and caches them
+    // only in process memory. `tokenUrl` must exactly match the selected Card
+    // OAuth2 clientCredentials flow. Use `kodax a2a enable|disable <name>` to
+    // mutate `enabled` atomically; the owning Runtime applies it asynchronously.
+    // "reviewer": {
+    //   "cardUrl": "https://reviewer.example.com/.well-known/agent-card.json",
+    //   "enabled": false,
+    //   "effect": "read",
+    //   "authentication": {
+    //     "type": "oauth2-client-credentials",
+    //     "scheme": "enterprise-oauth",
+    //     "issuer": "https://identity.example.com",
+    //     "tokenUrl": "https://identity.example.com/oauth/token",
+    //     "clientId": "kodax-reviewer",
+    //     "clientSecretEnv": "REVIEWER_CLIENT_SECRET",
+    //     "scopes": ["a2a.invoke"],
+    //     "resource": "https://reviewer.example.com/",
+    //     "clientAuthentication": "client-secret-basic"
+    //   }
+    // }
+  }
+}

package/config-templates/integrations/extensions.example.jsonc

@@ -1,7 +1,7 @@
-// Trusted user Extension paths: ~/.kodax/integrations/extensions.json.
-// Extensions are host code. Reload is whole-domain atomic; use MCP for
-// capabilities that should remain outside the KodaX process.
-{
-  "version": 1,
-  "paths": []
-}
+// Trusted user Extension paths: ~/.kodax/integrations/extensions.json.
+// Extensions are host code. Reload is whole-domain atomic; use MCP for
+// capabilities that should remain outside the KodaX process.
+{
+  "version": 1,
+  "paths": []
+}

package/config-templates/integrations/mcp.example.jsonc

@@ -1,16 +1,16 @@
-// User MCP declarations: ~/.kodax/integrations/mcp.json (strict JSON).
-// The whole file hot-reloads; healthy entries remain active if one new entry
-// fails to prepare. Keep credentials in ${env:NAME} references.
-{
-  "version": 1,
-  "servers": {}
-  // Example:
-  // "servers": {
-  //   "reporting": {
-  //     "type": "streamable-http",
-  //     "url": "https://mcp.example.com",
-  //     "headers": { "Authorization": "Bearer ${env:REPORTING_MCP_TOKEN}" },
-  //     "connect": "lazy"
-  //   }
-  // }
-}
+// User MCP declarations: ~/.kodax/integrations/mcp.json (strict JSON).
+// The whole file hot-reloads; healthy entries remain active if one new entry
+// fails to prepare. Keep credentials in ${env:NAME} references.
+{
+  "version": 1,
+  "servers": {}
+  // Example:
+  // "servers": {
+  //   "reporting": {
+  //     "type": "streamable-http",
+  //     "url": "https://mcp.example.com",
+  //     "headers": { "Authorization": "Bearer ${env:REPORTING_MCP_TOKEN}" },
+  //     "connect": "lazy"
+  //   }
+  // }
+}

package/dist/builtin/code-review/SKILL.md

@@ -1,82 +1,82 @@
----
-name: code-review
-description: 审查代码、diff、提交或当前 git 改动，重点发现 bug、行为回归、边界条件遗漏、安全风险、性能问题和缺失测试。当用户提到 code review、review 这段代码、帮我看看改动有没有问题、审查 PR/提交时使用；不要用于单纯解释代码或直接实现需求。
-user-invocable: true
-allowed-tools: "Read, Grep, Glob, Bash(npm:*, node:*, npx:*)"
-argument-hint: "[file-or-directory]"
-compatibility: "Works best in a git repository or when the review target is provided explicitly."
----
-
-# Code Review Skill
-
-对 **$ARGUMENTS** 进行代码审查，并优先输出真正会影响正确性、稳定性或可维护性的发现。
-
-## 范围判定
-
-- 如果提供了 `$ARGUMENTS`，审查对应文件、目录、diff 或提交范围。
-- 如果没有提供参数，优先审查当前 git 改动；如果不在 git 仓库中，就明确说明缺少范围并请求更具体的目标。
-- 在下结论前，尽量查看相邻实现、调用方、测试和相关配置，避免脱离上下文的误报。
-
-## 审查重点
-
-- 正确性与回归风险：逻辑错误、边界条件、状态同步、类型假设、兼容性变化。
-- 稳定性与安全性：异常处理、输入校验、资源泄漏、敏感信息暴露、权限或注入风险。
-- 性能与可维护性：明显的复杂度问题、重复逻辑、难以验证的实现、缺失测试保护。
-- 只报告有行动价值的问题。纯风格偏好或可选优化，不要包装成高优先级 finding。
-
-## 严重级别
-
-- `Critical`: 会导致数据丢失、严重安全问题、崩溃或明显错误结果。
-- `High`: 很可能引发实际 bug、行为回归或线上风险。
-- `Medium`: 不是立刻出错，但会留下明显缺陷、维护风险或测试空洞。
-- `Low`: 小范围问题或局部改进点，仅在确实值得用户处理时报告。
-
-## 输出要求
-
-- 先给 `## Findings`，并按严重级别从高到低排列。
-- 每条 finding 都要包含：
-  - 严重级别和简短标题
-  - 具体文件和行号
-  - 为什么这是问题，可能造成什么影响
-  - 建议的修复方向
-- 如果没有发现值得报告的问题，明确写 `No findings.`，然后补充剩余风险或测试空白。
-- 需要时再追加 `## Open Questions` 或 `## Change Summary`，但不要用总体打分或“亮点”冲淡问题。
-
-## 输出模板
-
-```markdown
-## Findings
-- [High] Title — `path/to/file.ts:42`
-  Why it matters and what to change.
-
-## Open Questions
-- Optional clarification or assumption.
-
-## Change Summary
-- Optional short summary only after findings.
-```
-
-## 使用示例
-
-- `/code-review src/auth.ts` - 审查单个文件
-- `/code-review packages/coding/src/` - 审查目录
-- `/code-review` - 审查当前 git 变更
-
-## Lean Review Lens
-
-When the user asks for lean review, minimal diff, YAGNI, over-engineering, or
-native/stdlib replacement opportunities, add this lens after correctness and
-security findings:
-
-- Look for code, files, abstractions, dependencies, configuration, or workflow
-  changes that can be deleted without losing requested behavior.
-- Prefer existing repository code, stdlib/native platform features, or an
-  already-installed dependency when that is verifiably simpler than new custom
-  code.
-- Do not recommend cutting trust-boundary validation, security checks,
-  data-loss protection, accessibility basics, observability needed for safety,
-  or explicitly requested behavior.
-- Do not present optional cleanup as a high-severity finding. Put non-blocking
-  deletion/replacement ideas under `## Lean Suggestions`.
-- For each lean suggestion, explain what can be skipped or removed and when it
-  should be added back.
+---
+name: code-review
+description: 审查代码、diff、提交或当前 git 改动，重点发现 bug、行为回归、边界条件遗漏、安全风险、性能问题和缺失测试。当用户提到 code review、review 这段代码、帮我看看改动有没有问题、审查 PR/提交时使用；不要用于单纯解释代码或直接实现需求。
+user-invocable: true
+allowed-tools: "Read, Grep, Glob, Bash(npm:*, node:*, npx:*)"
+argument-hint: "[file-or-directory]"
+compatibility: "Works best in a git repository or when the review target is provided explicitly."
+---
+
+# Code Review Skill
+
+对 **$ARGUMENTS** 进行代码审查，并优先输出真正会影响正确性、稳定性或可维护性的发现。
+
+## 范围判定
+
+- 如果提供了 `$ARGUMENTS`，审查对应文件、目录、diff 或提交范围。
+- 如果没有提供参数，优先审查当前 git 改动；如果不在 git 仓库中，就明确说明缺少范围并请求更具体的目标。
+- 在下结论前，尽量查看相邻实现、调用方、测试和相关配置，避免脱离上下文的误报。
+
+## 审查重点
+
+- 正确性与回归风险：逻辑错误、边界条件、状态同步、类型假设、兼容性变化。
+- 稳定性与安全性：异常处理、输入校验、资源泄漏、敏感信息暴露、权限或注入风险。
+- 性能与可维护性：明显的复杂度问题、重复逻辑、难以验证的实现、缺失测试保护。
+- 只报告有行动价值的问题。纯风格偏好或可选优化，不要包装成高优先级 finding。
+
+## 严重级别
+
+- `Critical`: 会导致数据丢失、严重安全问题、崩溃或明显错误结果。
+- `High`: 很可能引发实际 bug、行为回归或线上风险。
+- `Medium`: 不是立刻出错，但会留下明显缺陷、维护风险或测试空洞。
+- `Low`: 小范围问题或局部改进点，仅在确实值得用户处理时报告。
+
+## 输出要求
+
+- 先给 `## Findings`，并按严重级别从高到低排列。
+- 每条 finding 都要包含：
+  - 严重级别和简短标题
+  - 具体文件和行号
+  - 为什么这是问题，可能造成什么影响
+  - 建议的修复方向
+- 如果没有发现值得报告的问题，明确写 `No findings.`，然后补充剩余风险或测试空白。
+- 需要时再追加 `## Open Questions` 或 `## Change Summary`，但不要用总体打分或“亮点”冲淡问题。
+
+## 输出模板
+
+```markdown
+## Findings
+- [High] Title — `path/to/file.ts:42`
+  Why it matters and what to change.
+
+## Open Questions
+- Optional clarification or assumption.
+
+## Change Summary
+- Optional short summary only after findings.
+```
+
+## 使用示例
+
+- `/code-review src/auth.ts` - 审查单个文件
+- `/code-review packages/coding/src/` - 审查目录
+- `/code-review` - 审查当前 git 变更
+
+## Lean Review Lens
+
+When the user asks for lean review, minimal diff, YAGNI, over-engineering, or
+native/stdlib replacement opportunities, add this lens after correctness and
+security findings:
+
+- Look for code, files, abstractions, dependencies, configuration, or workflow
+  changes that can be deleted without losing requested behavior.
+- Prefer existing repository code, stdlib/native platform features, or an
+  already-installed dependency when that is verifiably simpler than new custom
+  code.
+- Do not recommend cutting trust-boundary validation, security checks,
+  data-loss protection, accessibility basics, observability needed for safety,
+  or explicitly requested behavior.
+- Do not present optional cleanup as a high-severity finding. Put non-blocking
+  deletion/replacement ideas under `## Lean Suggestions`.
+- For each lean suggestion, explain what can be skipped or removed and when it
+  should be added back.

package/dist/builtin/git-workflow/SKILL.md

@@ -1,84 +1,84 @@
----
-name: git-workflow
-description: 执行明确的 Git 操作，例如查看状态、提交、建分支、push、stash 或创建 PR。只有在用户明确要求实际执行这些 Git 操作时才使用；不要用于单纯解释 Git 概念或讨论策略。
-user-invocable: true
-disable-model-invocation: true
-allowed-tools: "Read, Grep, Glob, Bash(git:*, gh:*)"
-argument-hint: "[status|commit|branch|push|pr|stash] [args]"
-compatibility: "Requires a Git repository. Pull request creation works best when GitHub CLI (gh) is installed and authenticated."
----
-
-# Git Workflow Skill
-
-执行 Git 工作流时，优先保证仓库安全、改动边界清晰、命令可追溯。
-
-## 总流程
-
-1. 先检查仓库状态，例如 `git status --short --branch`，必要时补充 `git diff --stat`、`git diff --cached`、`git log --oneline`。
-2. 根据第一个参数判断操作类型；如果用户表达明确，就直接执行对应流程。
-3. 对会改写历史、删除数据或影响远程分支的操作，先说明风险；只有在用户明确要求时才继续。
-4. 所有 Git 命令都使用非交互方式执行。
-
-## 支持的操作
-
-### status
-- 汇总当前分支、upstream、已暂存/未暂存/未跟踪文件，以及明显的下一步建议。
-
-### commit
-- 只暂存与当前任务直接相关的文件；不要顺手带上无关改动。
-- 如果用户没有提供 message，基于 diff 生成简洁的 Conventional Commit。
-- 优先使用 `git add <path>`，避免无差别 `git add .`，除非用户明确要求全部提交。
-- 提交前检查是否混入敏感文件或明显不该提交的产物。
-
-**Commit 模板**
-```
-<type>(<scope>): <description>
-
-[optional body]
-
-[optional footer]
-```
-
-### branch
-- `create` / `new`: 创建新分支。除非用户指定，否则遵循仓库已有命名风格。
-- `switch` / `checkout`: 切换分支前，先检查当前工作区是否干净。
-- `list`: 列出本地/远程分支，并在有帮助时指出当前分支。
-- `delete` / `remove`: 仅在删除条件安全且用户请求明确时执行。
-
-### push
-- 先确认当前分支与 upstream 的关系。
-- 首次 push 或没有 upstream 时，设置合适的 upstream。
-- `--force` 或 `--force-with-lease` 只有在用户明确要求时才允许。
-
-### pr
-- 检查当前分支是否已 push，必要时先推送。
-- 基于 diff 和提交历史生成简洁的 PR 标题与描述。
-- 使用 `gh pr create` 前确认 `gh` 可用且已认证；否则清楚说明阻塞点。
-
-### stash
-- `save`: 有上下文时附带说明性消息。
-- `list`: 列出 stash，并说明最近一条的用途。
-- `pop`: 应用并删除最近 stash，若有冲突需明确报告。
-- `drop`: 仅在用户明确要求删除时执行。
-
-## 安全边界
-
-- 不要使用 `git reset --hard`、`git checkout --`、`git clean -fd`、`git commit --amend`、强推、历史改写等危险操作，除非用户明确要求。
-- 不要回滚、覆盖或丢弃用户的无关改动。
-- 遇到脏工作区、冲突、无 upstream、权限不足、缺少 `gh` 等阻塞时，要先解释现状再继续。
-- 对“合并分支”“rebase”“cherry-pick”等这里没有明确定义的操作，如果用户明确提出，可以按 Git 最佳实践执行，但要先说明风险和计划。
-
-## 汇报方式
-
-- 简洁说明执行了哪些命令、当前仓库状态变成了什么样。
-- 如果因为风险或条件不满足而没有执行，要明确说明原因和下一步建议。
-
-## 使用示例
-
-- `/git-workflow status` - 查看当前仓库状态
-- `/git-workflow commit` - 分析相关改动并提交
-- `/git-workflow commit "fix: resolve auth bug"` - 使用指定消息提交
-- `/git-workflow branch create feature/login` - 创建新分支
-- `/git-workflow push` - 推送当前分支
-- `/git-workflow pr` - 为当前分支创建 PR
-- `/git-workflow stash` - 暂存当前变更
+---
+name: git-workflow
+description: 执行明确的 Git 操作，例如查看状态、提交、建分支、push、stash 或创建 PR。只有在用户明确要求实际执行这些 Git 操作时才使用；不要用于单纯解释 Git 概念或讨论策略。
+user-invocable: true
+disable-model-invocation: true
+allowed-tools: "Read, Grep, Glob, Bash(git:*, gh:*)"
+argument-hint: "[status|commit|branch|push|pr|stash] [args]"
+compatibility: "Requires a Git repository. Pull request creation works best when GitHub CLI (gh) is installed and authenticated."
+---
+
+# Git Workflow Skill
+
+执行 Git 工作流时，优先保证仓库安全、改动边界清晰、命令可追溯。
+
+## 总流程
+
+1. 先检查仓库状态，例如 `git status --short --branch`，必要时补充 `git diff --stat`、`git diff --cached`、`git log --oneline`。
+2. 根据第一个参数判断操作类型；如果用户表达明确，就直接执行对应流程。
+3. 对会改写历史、删除数据或影响远程分支的操作，先说明风险；只有在用户明确要求时才继续。
+4. 所有 Git 命令都使用非交互方式执行。
+
+## 支持的操作
+
+### status
+- 汇总当前分支、upstream、已暂存/未暂存/未跟踪文件，以及明显的下一步建议。
+
+### commit
+- 只暂存与当前任务直接相关的文件；不要顺手带上无关改动。
+- 如果用户没有提供 message，基于 diff 生成简洁的 Conventional Commit。
+- 优先使用 `git add <path>`，避免无差别 `git add .`，除非用户明确要求全部提交。
+- 提交前检查是否混入敏感文件或明显不该提交的产物。
+
+**Commit 模板**
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+### branch
+- `create` / `new`: 创建新分支。除非用户指定，否则遵循仓库已有命名风格。
+- `switch` / `checkout`: 切换分支前，先检查当前工作区是否干净。
+- `list`: 列出本地/远程分支，并在有帮助时指出当前分支。
+- `delete` / `remove`: 仅在删除条件安全且用户请求明确时执行。
+
+### push
+- 先确认当前分支与 upstream 的关系。
+- 首次 push 或没有 upstream 时，设置合适的 upstream。
+- `--force` 或 `--force-with-lease` 只有在用户明确要求时才允许。
+
+### pr
+- 检查当前分支是否已 push，必要时先推送。
+- 基于 diff 和提交历史生成简洁的 PR 标题与描述。
+- 使用 `gh pr create` 前确认 `gh` 可用且已认证；否则清楚说明阻塞点。
+
+### stash
+- `save`: 有上下文时附带说明性消息。
+- `list`: 列出 stash，并说明最近一条的用途。
+- `pop`: 应用并删除最近 stash，若有冲突需明确报告。
+- `drop`: 仅在用户明确要求删除时执行。
+
+## 安全边界
+
+- 不要使用 `git reset --hard`、`git checkout --`、`git clean -fd`、`git commit --amend`、强推、历史改写等危险操作，除非用户明确要求。
+- 不要回滚、覆盖或丢弃用户的无关改动。
+- 遇到脏工作区、冲突、无 upstream、权限不足、缺少 `gh` 等阻塞时，要先解释现状再继续。
+- 对“合并分支”“rebase”“cherry-pick”等这里没有明确定义的操作，如果用户明确提出，可以按 Git 最佳实践执行，但要先说明风险和计划。
+
+## 汇报方式
+
+- 简洁说明执行了哪些命令、当前仓库状态变成了什么样。
+- 如果因为风险或条件不满足而没有执行，要明确说明原因和下一步建议。
+
+## 使用示例
+
+- `/git-workflow status` - 查看当前仓库状态
+- `/git-workflow commit` - 分析相关改动并提交
+- `/git-workflow commit "fix: resolve auth bug"` - 使用指定消息提交
+- `/git-workflow branch create feature/login` - 创建新分支
+- `/git-workflow push` - 推送当前分支
+- `/git-workflow pr` - 为当前分支创建 PR
+- `/git-workflow stash` - 暂存当前变更