@ia-ccun/code-agent-cli 0.0.18 → 0.0.20

package/config/agent/extensions/context-monitor.ts

@@ -0,0 +1,274 @@
+/**
+ * Context Monitor Extension — 自动检测上下文大小并在接近阈值时警告
+ *
+ * 功能：
+ * 1. 自动检测每轮对话后的上下文使用情况
+ * 2. 在超过阈值时自动发出不同级别的警告
+ * 3. 提供清理建议和上下文统计
+ *
+ * 阈值级别：
+ * - 70%   : info 级别提示
+ * - 80%   : warning 级别警告
+ * - 90%   : error 级别严重警告
+ * - 100%  : 阻止继续并强制提示压缩
+ */
+
+import type { ExtensionAPI, ExtensionContext, ToolResultEvent } from "@mariozechner/pi-coding-agent";
+
+interface ContextThresholds {
+	info: number;    // 70%
+	warning: number; // 80%
+	error: number;   // 90%
+	critical: number; // 100%
+}
+
+const DEFAULT_THRESHOLDS: ContextThresholds = {
+	info: 70,
+	warning: 80,
+	error: 90,
+	critical: 100,
+};
+
+interface ContextStats {
+	contextWindow: number;
+	usedTokens: number;
+	remainingTokens: number;
+	percent: number;
+	systemTokens: number;
+	toolsTokens: number;
+	conversationTokens: number;
+}
+
+function estimateTokens(text: string): number {
+	return Math.max(0, Math.ceil(text.length / 4));
+}
+
+function formatTokens(n: number): string {
+	if (n < 1000) return n.toString();
+	if (n < 1000000) return `${(n / 1000).toFixed(1)}k`;
+	return `${(n / 1000000).toFixed(1)}M`;
+}
+
+function getContextLevel(percent: number): "normal" | "info" | "warning" | "error" | "critical" {
+	if (percent >= DEFAULT_THRESHOLDS.critical) return "critical";
+	if (percent >= DEFAULT_THRESHOLDS.error) return "error";
+	if (percent >= DEFAULT_THRESHOLDS.warning) return "warning";
+	if (percent >= DEFAULT_THRESHOLDS.info) return "info";
+	return "normal";
+}
+
+function getContextMessage(stats: ContextStats): { level: "info" | "warning" | "error"; title: string; body: string } {
+	const level = getContextLevel(stats.percent);
+	const contextBar = renderContextBar(stats.percent);
+
+	let title: string;
+	let body: string;
+
+	switch (level) {
+		case "critical":
+			title = "🚨 上下文已满!";
+			body = `上下文窗口已完全使用! (${contextBar})\n剩余: ${formatTokens(stats.remainingTokens)} tokens\n\n⚠️ 请立即使用 /clear 清理会话或开启新会话!`;
+			break;
+		case "error":
+			title = "⚠️ 上下文即将耗尽";
+			body = `上下文使用: ${contextBar}\n已用: ${formatTokens(stats.usedTokens)} / ${formatTokens(stats.contextWindow)}\n剩余: ${formatTokens(stats.remainingTokens)} tokens\n\n💡 建议: 使用 /clear 清理会话`;
+			break;
+		case "warning":
+			title = "📊 上下文使用较高";
+			body = `上下文使用: ${contextBar}\n已用: ${formatTokens(stats.usedTokens)} / ${formatTokens(stats.contextWindow)}\n剩余: ${formatTokens(stats.remainingTokens)} tokens\n\n💡 提示: 可以考虑压缩会话`;
+			break;
+		case "info":
+			title = "ℹ️ 上下文使用提醒";
+			body = `上下文使用: ${contextBar}\n已用: ${formatTokens(stats.usedTokens)} / ${formatTokens(stats.contextWindow)}\n\n💡 提示: 上下文已使用过半，注意控制对话长度`;
+			break;
+		default:
+			title = "✅ 上下文状态正常";
+			body = `上下文使用: ${contextBar}\n已用: ${formatTokens(stats.usedTokens)} / ${formatTokens(stats.contextWindow)}\n剩余: ${formatTokens(stats.remainingTokens)} tokens`;
+	}
+
+	return { level, title, body };
+}
+
+function renderContextBar(percent: number, width: number = 20): string {
+	const filled = Math.min(width, Math.round((percent / 100) * width));
+	const empty = width - filled;
+
+	const filledChar = "█";
+	const emptyChar = "░";
+
+	return filledChar.repeat(filled) + emptyChar.repeat(empty) + ` ${percent.toFixed(1)}%`;
+}
+
+export default function contextMonitorExtension(pi: ExtensionAPI) {
+	// 配置：是否启用自动警告
+	let autoWarnEnabled = true;
+	let lastWarnedLevel: string = "normal";
+	let warnCooldown = 0; // 防止连续警告
+
+	/**
+	 * 获取当前上下文统计
+	 */
+	function getContextStats(ctx: ExtensionContext): ContextStats | null {
+		const usage = ctx.getContextUsage();
+		if (!usage) return null;
+
+		const contextWindow = usage.contextWindow || ctx.model?.contextWindow || 0;
+		if (contextWindow === 0) return null;
+
+		const usedTokens = usage.tokens || 0;
+		const remainingTokens = Math.max(0, contextWindow - usedTokens);
+		const percent = (usedTokens / contextWindow) * 100;
+
+		// 估算各部分 token
+		const systemPrompt = ctx.getSystemPrompt();
+		const systemTokens = systemPrompt ? estimateTokens(systemPrompt) : 0;
+		const toolsTokens = Math.round(
+			pi.getActiveTools().reduce((sum, name) => {
+				const info = pi.getAllTools().find((t) => t.name === name);
+				return sum + estimateTokens(`${name}\n${info?.description || ""}`);
+			}, 0) * 1.5
+		);
+		const conversationTokens = Math.max(0, usedTokens - systemTokens - toolsTokens);
+
+		return {
+			contextWindow,
+			usedTokens,
+			remainingTokens,
+			percent,
+			systemTokens,
+			toolsTokens,
+			conversationTokens,
+		};
+	}
+
+	/**
+	 * 处理上下文警告
+	 */
+	async function handleContextWarning(stats: ContextStats, ctx: ExtensionContext) {
+		if (!autoWarnEnabled) return;
+
+		const level = getContextLevel(stats.percent);
+		const message = getContextMessage(stats);
+
+		// 避免重复警告（同级别）
+		if (level === lastWarnedLevel && warnCooldown > 0) {
+			warnCooldown--;
+			return;
+		}
+
+		// 只在有新级别时警告
+		const levels = ["normal", "info", "warning", "error", "critical"];
+		const currentIdx = levels.indexOf(level);
+		const lastIdx = levels.indexOf(lastWarnedLevel);
+
+		if (currentIdx <= lastIdx && level !== "critical") return;
+
+		lastWarnedLevel = level;
+		warnCooldown = 3; // 设置冷却
+
+		// 发送通知
+		ctx.ui.notify(message.title, message.level as any);
+	}
+
+	// 监听轮次结束事件，检查上下文使用
+	pi.on("turn_end", async (_event, ctx: ExtensionContext) => {
+		const stats = getContextStats(ctx);
+		if (!stats) return;
+
+		await handleContextWarning(stats, ctx);
+	});
+
+	// 监听会话开始，初始化
+	pi.on("session_start", async (_event, ctx: ExtensionContext) => {
+		lastWarnedLevel = "normal";
+		warnCooldown = 0;
+	});
+
+	/**
+	 * /context-stats 命令 - 显示详细上下文统计
+	 */
+	pi.registerCommand("context-stats", {
+		description: "显示当前上下文详细统计",
+		usage: "/context-stats",
+		handler: async (_args, ctx: ExtensionContext) => {
+			const stats = getContextStats(ctx);
+
+			if (!stats) {
+				ctx.ui.notify("无法获取上下文统计", "warning");
+				return;
+			}
+
+			const message = getContextMessage(stats);
+			const lines = message.body.split("\n");
+
+			// 构建详细统计文本
+			const modelName = ctx.model?.name || "unknown";
+			const modelMaxTokens = ctx.model?.maxTokens || 0;
+			const contextWindow = stats.contextWindow;
+
+			// 根据使用情况给出建议
+			let suggestion = "";
+			if (stats.percent >= 90) {
+				suggestion = `⚠️ 上下文使用过高，建议清理会话\n💡 模型 ${modelName} 最大窗口 ${formatTokens(contextWindow)}`;
+			} else if (stats.percent >= 70) {
+				suggestion = `💡 上下文已过半，注意控制对话长度`;
+			}
+
+			const detailLines = [
+				`${"─".repeat(40)}`,
+				`📊 上下文详细统计`,
+				`${"─".repeat(40)}`,
+				``,
+				`模型:     ${modelName}`,
+				`总窗口:   ${formatTokens(contextWindow)} tokens`,
+				`最大输出: ${formatTokens(modelMaxTokens)} tokens`,
+				`已使用:   ${formatTokens(stats.usedTokens)} tokens (${stats.percent.toFixed(1)}%)`,
+				`剩余:     ${formatTokens(stats.remainingTokens)} tokens`,
+				``,
+				`📝 分布估算:`,
+				`  系统:   ${formatTokens(stats.systemTokens)} tokens`,
+				`  工具:   ${formatTokens(stats.toolsTokens)} tokens`,
+				`  对话:   ${formatTokens(stats.conversationTokens)} tokens`,
+				``,
+				suggestion,
+				``,
+				`${"─".repeat(40)}`,
+			];
+
+			// 显示给用户
+			const fullText = detailLines.join("\n");
+			pi.sendMessage(
+				{
+					customType: "context-stats",
+					content: fullText,
+					display: true,
+				},
+				{ triggerTurn: false }
+			);
+
+			// 如果超过阈值也显示通知
+			if (stats.percent >= 80) {
+				ctx.ui.notify(message.title, message.level as any);
+			}
+		},
+	});
+
+	/**
+	 * /context-warn 命令 - 切换自动警告
+	 */
+	pi.registerCommand("context-warn", {
+		description: "开启/关闭上下文警告",
+		usage: "/context-warn [on|off]",
+		handler: async (args, ctx: ExtensionContext) => {
+			if (!args || args === "on") {
+				autoWarnEnabled = true;
+				ctx.ui.notify("✅ 上下文警告已开启", "info");
+			} else if (args === "off") {
+				autoWarnEnabled = false;
+				ctx.ui.notify("🔕 上下文警告已关闭", "info");
+			} else {
+				ctx.ui.notify(`当前状态: ${autoWarnEnabled ? "开启" : "关闭"}`, "info");
+			}
+		},
+	});
+}

package/config/agent/models.json

@@ -4,18 +4,17 @@
       "name": "OpenAI",
       "baseUrl": "https://ai-llm.xxx.com/v1",
       "api": "openai-completions",
-      "apiKey": "YOUR_API_KEY_HERE",
+      "apiKey": "你自己的APIKEY",
       "headers": {
-        "User-Agent": "aicode-cli",
-        "sourceIp": "!hostname -I 2>/dev/null | awk '{print $1}' || ipconfig getifaddr en0 2>/dev/null || echo ''"
+        "User-Agent": "${VERSION}"
       },
       "models": [
         {
           "id": "GLM-4.7-W8A8",
           "name": "GLM4.7",
-          "contextWindow": 200000,
-          "maxTokens": 100000,
-          "reasoning": false,
+          "contextWindow": 99000,
+          "maxTokens": 99000,
+          "reasoning": true,
           "input": ["text"],
           "cost": {
             "input": 5,

package/config/agent/prompts/code-simplifier.md

@@ -1,7 +1,7 @@
 ---
 name: code-simplifier
-description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
-autho: xujianjiang
+description: "Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise."
+author: xujianjiang
 ---
 
 You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.

package/config/agent/prompts/feat.md

@@ -1,6 +1,6 @@
 ---
 name: feat
-description: '用于新增功能开发的命令，支持完整的开发流程和工具集成'
+description: "用于新增功能开发的命令，支持完整的开发流程和工具集成"
 ---
 
 $ARGUMENTS

package/config/agent/prompts/git-commit.md

@@ -1,5 +1,6 @@
 ---
-description: 仅用 Git 分析改动并自动生成 conventional commit 信息（可选 emoji）；必要时建议拆分提交，默认运行本地 Git 钩子（可 --no-verify 跳过）
+name: git-commit
+description: "仅用 Git 分析改动并自动生成 conventional commit 信息（可选 emoji）；必要时建议拆分提交，默认运行本地 Git 钩子（可 --no-verify 跳过）"
 allowed-tools: Read(**), Exec(git status, git diff, git add, git restore --staged, git commit, git rev-parse, git config), Write(.git/COMMIT_EDITMSG)
 argument-hint: "[--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <scope>] [--type <type>]"
 ---

package/config/agent/prompts/git-rollback.md

@@ -1,5 +1,6 @@
 ---
-description: 交互式回滚 Git 分支到历史版本；列分支、列版本、二次确认后执行 reset / revert
+name: git-rollback
+description: "交互式回滚 Git 分支到历史版本；列分支、列版本、二次确认后执行 reset / revert"
 allowed-tools: Read(**), Exec(git fetch, git branch, git tag, git log, git reflog, git checkout, git reset, git revert, git switch), Write()
 argument-hint: "[--branch <branch>] [--target <rev>] [--mode reset|revert] [--depth <n>] [--dry-run] [--yes]"
 ---

package/config/agent/prompts/git-worktree.md

@@ -1,5 +1,6 @@
 ---
-description: 管理 Git worktree 
+name: git-worktree
+description: "管理 Git worktree" 
 allowed-tools: Read(**), Exec(git worktree add, git worktree list, git worktree remove, git worktree prune, git branch, git checkout, git rev-parse, git stash, git cp, detect-ide, open-ide, which, command, basename, dirname)
 argument-hint: <add|list|remove|prune|migrate> [path] [-b <branch>] [-o|--open] [--track] [--guess-remote] [--detach] [--checkout] [--lock] [--migrate-from <source-path>] [--migrate-stash]
 ---

package/config/agent/prompts/help.md

@@ -1,6 +1,6 @@
 ---
 name: help
-description: 查看 aicode-cli 使用帮助手册,具体请读取 `~/.aicode-cli/agent/help.md` 文件的内容
+description: "查看 aicode-cli 使用帮助手册,具体请读取 `~/.aicode-cli/agent/help.md` 文件的内容"
 ---
 
 # 帮助命令

package/config/agent/prompts/init-project.md

@@ -1,5 +1,6 @@
 ---
-description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
+name: init-project
+description: "初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引"
 allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
 argument-hint: <项目摘要或名称>
 ---

package/config/agent/prompts/workflow.md

@@ -1,5 +1,6 @@
 ---
-description: '专业AI编程助手，提供结构化六阶段开发工作流（研究→构思→计划→执行→优化→评审），适用于专业开发者'
+name: workflow
+description: "专业AI编程助手，提供结构化六阶段开发工作流（研究→构思→计划→执行→优化→评审），适用于专业开发者"
 ---
 
 # Workflow - 专业开发助手

package/config/agent/skills/csv-data-summarizer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: csv-data-summarizer
-description: Analyzes CSV files, generates summary stats, and plots quick visualizations using Python and pandas.
+description: "Analyzes CSV files, generates summary stats, and plots quick visualizations using Python and pandas."
 metadata:
   version: 2.1.0
   dependencies: python>=3.8, pandas>=2.0.0, matplotlib>=3.7.0, seaborn>=0.12.0

package/config/agent/skills/dispatching-parallel-agents/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: dispatching-parallel-agents
 author: xujianjiang
-description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
+description: "Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies"
 ---
 
 # Dispatching Parallel Agents

package/config/agent/skills/executing-plans/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: executing-plans
 author: xujianjiang
-description: Use when you have a written implementation plan to execute in a separate session with review checkpoints
+description: "Use when you have a written implementation plan to execute in a separate session with review checkpoints"
 ---
 
 # Executing Plans

package/config/agent/skills/find-skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: find-skills
-description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+description: "Helps users discover and install agent skills when they ask questions like 'how do I do X', 'find a skill for X', 'is there a skill that can...', or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill."
 ---
 
 # Find Skills

package/config/agent/skills/finishing-a-development-branch/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: finishing-a-development-branch
 author: xujianjiang
-description: Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
+description: "Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup"
 ---
 
 # Finishing a Development Branch

package/config/agent/skills/frontend-design/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: frontend-design
-description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
+description: "Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics."
 license: Complete terms in LICENSE.txt
 ---
 

package/config/agent/skills/librarian/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: librarian
-description: Research open-source libraries with evidence-backed answers and GitHub permalinks. Use when the user asks about library internals, needs implementation details with source code references, wants to understand why something was changed, or needs authoritative answers backed by actual code. Excels at navigating large open-source repos and providing citations to exact lines of code.
+description: "Research open-source libraries with evidence-backed answers and GitHub permalinks. Use when the user asks about library internals, needs implementation details with source code references, wants to understand why something was changed, or needs authoritative answers backed by actual code. Excels at navigating large open-source repos and providing citations to exact lines of code."
 ---
 
 # Librarian

package/config/agent/skills/owasp-security/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: owasp-security
 author: xujianjiang
-description: Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability.
+description: "Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability."
 ---
 
 # OWASP Top 10 Security

package/config/agent/skills/receiving-code-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: receiving-code-review
 author: xujianjiang
-description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
+description: "Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation"
 ---
 
 # Code Review Reception

package/config/agent/skills/requesting-code-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: requesting-code-review
 author: xujianjiang
-description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements
+description: "Use when completing tasks, implementing major features, or before merging to verify work meets requirements"
 ---
 
 # Requesting Code Review

package/config/agent/skills/skill-creator/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: skill-creator
 author: xujianjiang
-description: Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
+description: "Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy."
 ---
 
 # Skill Creator

package/config/agent/skills/subagent-driven-development/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: subagent-driven-development
 author: xujianjiang
-description: Use when executing implementation plans with independent tasks in the current session
+description: "Use when executing implementation plans with independent tasks in the current session"
 ---
 
 # Subagent-Driven Development

package/config/agent/skills/systematic-debugging/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: systematic-debugging
 author: xujianjiang
-description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
+description: "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes"
 ---
 
 # Systematic Debugging

package/config/agent/skills/test-driven-development/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: test-driven-development
 author: xujianjiang
-description: Use when implementing any feature or bugfix, before writing implementation code
+description: "Use when implementing any feature or bugfix, before writing implementation code"
 ---
 
 # Test-Driven Development (TDD)

package/config/agent/skills/using-git-worktrees/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: using-git-worktrees
 author: xujianjiang
-description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
+description: "Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification"
 ---
 
 # Using Git Worktrees

package/config/agent/skills/using-superpowers/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: using-superpowers
 author: xujianjiang
-description: Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions
+description: "Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions"
 ---
 
 <SUBAGENT-STOP>

package/config/agent/skills/verification-before-completion/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: verification-before-completion
 author: xujianjiang
-description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
+description: "Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always"
 ---
 
 # Verification Before Completion

package/config/agent/skills/writing-plans/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: writing-plans
 author: xujianjiang
-description: Use when you have a spec or requirements for a multi-step task, before touching code
+description: "Use when you have a spec or requirements for a multi-step task, before touching code"
 ---
 
 # Writing Plans

package/config/agent/skills/writing-skills/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: writing-skills
 author: xujianjiang
-description: Use when creating new skills, editing existing skills, or verifying skills work before deployment
+description: "Use when creating new skills, editing existing skills, or verifying skills work before deployment"
 ---
 
 # Writing Skills
@@ -107,7 +107,7 @@ skills/
 ---
 name: Skill-Name-With-Hyphens
 author: xujianjiang
-description: Use when [specific triggering conditions and symptoms]
+description: "Use when [specific triggering conditions and symptoms]"
 ---
 
 # Skill Name
@@ -162,19 +162,19 @@ When the description was changed to just "Use when executing implementation plan
 ```yaml
 # ❌ BAD: Summarizes workflow - Claude may follow this instead of reading skill
 author: xujianjiang
-description: Use when executing plans - dispatches subagent per task with code review between tasks
+description: "Use when executing plans - dispatches subagent per task with code review between tasks"
 
 # ❌ BAD: Too much process detail
 author: xujianjiang
-description: Use for TDD - write test first, watch it fail, write minimal code, refactor
+description: "Use for TDD - write test first, watch it fail, write minimal code, refactor"
 
 # ✅ GOOD: Just triggering conditions, no workflow summary
 author: xujianjiang
-description: Use when executing implementation plans with independent tasks in the current session
+description: "Use when executing implementation plans with independent tasks in the current session"
 
 # ✅ GOOD: Triggering conditions only
 author: xujianjiang
-description: Use when implementing any feature or bugfix, before writing implementation code
+description: "Use when implementing any feature or bugfix, before writing implementation code"
 ```
 
 **Content:**
@@ -188,23 +188,23 @@ description: Use when implementing any feature or bugfix, before writing impleme
 ```yaml
 # ❌ BAD: Too abstract, vague, doesn't include when to use
 author: xujianjiang
-description: For async testing
+description: "For async testing"
 
 # ❌ BAD: First person
 author: xujianjiang
-description: I can help you with async tests when they're flaky
+description: "I can help you with async tests when they're flaky"
 
 # ❌ BAD: Mentions technology but skill isn't specific to it
 author: xujianjiang
-description: Use when tests use setTimeout/sleep and are flaky
+description: "Use when tests use setTimeout/sleep and are flaky"
 
 # ✅ GOOD: Starts with "Use when", describes problem, no workflow
 author: xujianjiang
-description: Use when tests have race conditions, timing dependencies, or pass/fail inconsistently
+description: "Use when tests have race conditions, timing dependencies, or pass/fail inconsistently"
 
 # ✅ GOOD: Technology-specific skill with explicit trigger
 author: xujianjiang
-description: Use when using React Router and handling authentication redirects
+description: "Use when using React Router and handling authentication redirects"
 ```
 
 ### 2. Keyword Coverage
@@ -539,7 +539,7 @@ Add to description: symptoms of when you're ABOUT to violate the rule:
 
 ```yaml
 author: xujianjiang
-description: use when implementing any feature or bugfix, before writing implementation code
+description: "use when implementing any feature or bugfix, before writing implementation code"
 ```
 
 ## RED-GREEN-REFACTOR for Skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-ccun/code-agent-cli",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "AI Coding Agent CLI - 基于OpenClaw🦞底层Agent原理实现的的编码智能体（供学习使用）。",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,10 +35,10 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@mariozechner/pi-agent-core": "0.60.0",
-    "@mariozechner/pi-ai": "0.60.0",
-    "@mariozechner/pi-coding-agent": "0.60.0",
-    "@mariozechner/pi-tui": "0.60.0"
+    "@mariozechner/pi-agent-core": "0.62.0",
+    "@mariozechner/pi-ai": "0.62.0",
+    "@mariozechner/pi-coding-agent": "0.62.0",
+    "@mariozechner/pi-tui": "0.62.0"
   },
   "overrides": {
     "glob": "^11.0.0",