chore: release v1.6.0

Author: yeasy

CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 
 
+## [1.6.0] - 2026-02-07
+
+### Added
+- **Internationalization**: Added complete Chinese documentation for all `docs/` files (e.g., `README_zh.md`, `commands_zh.md`).
+- **Prompt Integration**: New `ask skill prompt` command to generate XML skill listings for Agentic AI prompts (following [Agent Skills Spec](https://agentskills.io/specification)).
+- **Validation**: Enhanced `SKILL.md` validation logic to rigidly enforce spec compliance (names, descriptions).
+
+### Fixed
+- **Cleanup**: Removed unused `formatPathForPrompt` function in `cmd/prompt.go`.
+
 ## [1.5.1] - 2026-02-04
 
 ### Changed

README.md

@@ -148,7 +148,8 @@ ask serve
 | `ask skill uninstall <name>` | Remove a skill |
 | `ask skill update` | Update skills to latest version |
 | `ask skill outdated` | Check for newer versions |
-| `ask skill check <path>` | Security scan (Secrets, Dangerous Commands) |
+| `ask skill check <path>` | Security scan + SKILL.md format validation |
+| `ask skill prompt [paths]` | Generate XML for agent system prompts |
 
 ### Repository Management
 | Command | Description |

README_zh.md

@@ -149,7 +149,8 @@ ask serve
 | `ask uninstall <name>` | 卸载 Skill |
 | `ask update` | 更新 Skill 到最新版本 |
 | `ask outdated` | 检查可用更新 |
-| `ask check <path>` | 安全扫描 (密钥泄漏, 危险命令等) |
+| `ask check <path>` | 安全扫描 + SKILL.md 格式验证 |
+| `ask skill prompt [paths]` | 生成 XML 格式供 Agent 系统提示使用 |
 
 ### 仓库管理
 | 命令 | 说明 |

cmd/prompt.go

@@ -0,0 +1,178 @@
+package cmd
+
+import (
+	"encoding/xml"
+	"fmt"
+	"os"
+	"path/filepath"
+
+	"github.com/spf13/cobra"
+	"github.com/yeasy/ask/internal/config"
+	"github.com/yeasy/ask/internal/skill"
+)
+
+// AvailableSkills represents the XML structure for agent prompt integration
+type AvailableSkills struct {
+	XMLName xml.Name     `xml:"available_skills"`
+	Skills  []SkillEntry `xml:"skill"`
+}
+
+// SkillEntry represents a single skill in the XML output
+type SkillEntry struct {
+	Name        string `xml:"name"`
+	Description string `xml:"description"`
+	Location    string `xml:"location"`
+}
+
+var promptOutputFile string
+
+// promptCmd represents the prompt command
+var promptCmd = &cobra.Command{
+	Use:   "prompt [paths...]",
+	Short: "Generate XML skill listing for agent prompts",
+	Long: `Generate <available_skills> XML block for agent system prompts.
+
+This format is recommended for Anthropic's models and follows the
+Agent Skills specification at https://agentskills.io/specification.
+
+If no paths are specified, scans installed skills in default locations.
+
+Examples:
+  ask skill prompt                          # Scan all installed skills
+  ask skill prompt .agent/skills/pdf        # Single skill
+  ask skill prompt ./skills/a ./skills/b    # Multiple skills`,
+	Run: runPrompt,
+}
+
+func init() {
+	promptCmd.Flags().StringVarP(&promptOutputFile, "output", "o", "", "Write XML to file instead of stdout")
+}
+
+func runPrompt(_ *cobra.Command, args []string) {
+	var skillPaths []string
+
+	if len(args) > 0 {
+		// Use provided paths
+		for _, arg := range args {
+			absPath, err := filepath.Abs(arg)
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "Error resolving path %s: %v\n", arg, err)
+				continue
+			}
+			if skill.FindSkillMD(absPath) {
+				skillPaths = append(skillPaths, absPath)
+			} else {
+				fmt.Fprintf(os.Stderr, "Warning: %s is not a valid skill (no SKILL.md found)\n", arg)
+			}
+		}
+	} else {
+		// Scan default locations
+		skillPaths = discoverInstalledSkills()
+	}
+
+	if len(skillPaths) == 0 {
+		fmt.Fprintln(os.Stderr, "No skills found.")
+		os.Exit(1)
+	}
+
+	// Build XML structure
+	availableSkills := AvailableSkills{}
+	for _, path := range skillPaths {
+		meta, err := skill.ParseSkillMD(path)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Warning: failed to parse %s: %v\n", path, err)
+			continue
+		}
+
+		entry := SkillEntry{
+			Name:        meta.Name,
+			Description: meta.Description,
+			Location:    filepath.Join(path, "SKILL.md"),
+		}
+		availableSkills.Skills = append(availableSkills.Skills, entry)
+	}
+
+	// Generate XML
+	output, err := xml.MarshalIndent(availableSkills, "", "  ")
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error generating XML: %v\n", err)
+		os.Exit(1)
+	}
+
+	xmlContent := string(output)
+
+	if promptOutputFile != "" {
+		if err := os.WriteFile(promptOutputFile, []byte(xmlContent), 0644); err != nil {
+			fmt.Fprintf(os.Stderr, "Error writing to %s: %v\n", promptOutputFile, err)
+			os.Exit(1)
+		}
+		fmt.Printf("XML written to %s\n", promptOutputFile)
+	} else {
+		fmt.Println(xmlContent)
+	}
+}
+
+// discoverInstalledSkills finds all installed skills in known locations
+func discoverInstalledSkills() []string {
+	var paths []string
+	cwd, _ := os.Getwd()
+	home, _ := os.UserHomeDir()
+
+	// Locations to scan
+	searchDirs := []string{
+		filepath.Join(cwd, config.DefaultSkillsDir),
+		filepath.Join(cwd, "skills"),
+	}
+
+	// Add agent-specific directories
+	for _, agentConfig := range config.SupportedAgents {
+		searchDirs = append(searchDirs, filepath.Join(cwd, agentConfig.ProjectDir))
+		if home != "" {
+			searchDirs = append(searchDirs, filepath.Join(home, agentConfig.GlobalDir))
+		}
+	}
+
+	// Add global skills directory
+	if home != "" {
+		searchDirs = append(searchDirs, filepath.Join(home, ".ask", "skills"))
+	}
+
+	// Deduplicate and scan
+	seen := make(map[string]bool)
+	for _, dir := range searchDirs {
+		if seen[dir] {
+			continue
+		}
+		seen[dir] = true
+
+		entries, err := os.ReadDir(dir)
+		if err != nil {
+			continue
+		}
+
+		for _, entry := range entries {
+			if !entry.IsDir() {
+				continue
+			}
+			skillPath := filepath.Join(dir, entry.Name())
+			if skill.FindSkillMD(skillPath) {
+				// Use absolute path for deduplication
+				absPath, _ := filepath.Abs(skillPath)
+				if !containsPath(paths, absPath) {
+					paths = append(paths, absPath)
+				}
+			}
+		}
+	}
+
+	return paths
+}
+
+func containsPath(paths []string, target string) bool {
+	for _, p := range paths {
+		if p == target {
+			return true
+		}
+	}
+	return false
+}

cmd/prompt_test.go

@@ -0,0 +1,103 @@
+package cmd
+
+import (
+	"os"
+	"path/filepath"
+	"strings"
+	"testing"
+)
+
+func TestPromptCommand_SingleSkill(t *testing.T) {
+	tmpDir := t.TempDir()
+	skillDir := filepath.Join(tmpDir, "test-skill")
+	if err := os.Mkdir(skillDir, 0755); err != nil {
+		t.Fatal(err)
+	}
+
+	// Create valid SKILL.md
+	skillMD := `---
+name: test-skill
+description: A test skill for prompt generation
+---
+# Test Skill
+`
+	if err := os.WriteFile(filepath.Join(skillDir, "SKILL.md"), []byte(skillMD), 0644); err != nil {
+		t.Fatal(err)
+	}
+
+	// Build available skills
+	paths := []string{skillDir}
+	availableSkills := AvailableSkills{}
+
+	for _, path := range paths {
+		meta, err := parseSkillMDForTest(path)
+		if err != nil {
+			t.Fatalf("Failed to parse skill: %v", err)
+		}
+		entry := SkillEntry{
+			Name:        meta.name,
+			Description: meta.description,
+			Location:    filepath.Join(path, "SKILL.md"),
+		}
+		availableSkills.Skills = append(availableSkills.Skills, entry)
+	}
+
+	if len(availableSkills.Skills) != 1 {
+		t.Errorf("Expected 1 skill, got %d", len(availableSkills.Skills))
+	}
+
+	if availableSkills.Skills[0].Name != "test-skill" {
+		t.Errorf("Expected name 'test-skill', got '%s'", availableSkills.Skills[0].Name)
+	}
+}
+
+// Helper to parse SKILL.md for testing
+type testMeta struct {
+	name        string
+	description string
+}
+
+func parseSkillMDForTest(skillPath string) (*testMeta, error) {
+	content, err := os.ReadFile(filepath.Join(skillPath, "SKILL.md"))
+	if err != nil {
+		return nil, err
+	}
+
+	meta := &testMeta{}
+	lines := strings.Split(string(content), "\n")
+	inFrontmatter := false
+
+	for _, line := range lines {
+		line = strings.TrimSpace(line)
+		if line == "---" {
+			if !inFrontmatter {
+				inFrontmatter = true
+				continue
+			} else {
+				break
+			}
+		}
+		if inFrontmatter {
+			if strings.HasPrefix(line, "name:") {
+				meta.name = strings.TrimSpace(strings.TrimPrefix(line, "name:"))
+			}
+			if strings.HasPrefix(line, "description:") {
+				meta.description = strings.TrimSpace(strings.TrimPrefix(line, "description:"))
+			}
+		}
+	}
+
+	return meta, nil
+}
+
+func TestContainsPath(t *testing.T) {
+	paths := []string{"/a/b/c", "/d/e/f"}
+
+	if !containsPath(paths, "/a/b/c") {
+		t.Error("Expected to find /a/b/c")
+	}
+
+	if containsPath(paths, "/x/y/z") {
+		t.Error("Did not expect to find /x/y/z")
+	}
+}

cmd/root.go

@@ -61,7 +61,7 @@ Codex, etc.) with a familiar CLI experience, just like Homebrew or npm.`,
 }
 
 // Version is the current version of the application
-const Version = "1.5.1"
+const Version = "1.6.0"
 
 // Top-level aliases (Docker-style)
 var installRootCmd = &cobra.Command{
@@ -152,7 +152,7 @@ func init() {
 	// It's likely defined in list.go.
 	// We should probably just copy flags setup here.
 	uninstallRootCmd.Flags().AddFlagSet(uninstallCmd.Flags())
-	checkRootCmd.Flags().StringVarP(&outputFile, "output", "o", "", "Write report to file (supports .md, .html/.htm, .json)")
+	checkRootCmd.Flags().AddFlagSet(checkCmd.Flags())
 }
 
 // initConfig reads in config file and ENV variables if set.

cmd/skill.go

@@ -21,4 +21,5 @@ Examples:
 func init() {
 	rootCmd.AddCommand(skillCmd)
 	skillCmd.AddCommand(checkCmd)
+	skillCmd.AddCommand(promptCmd)
 }

docs/README_zh.md

@@ -0,0 +1,25 @@
+# ASK 文档
+
+欢迎阅读 ASK (Agent Skills Kit) 文档。
+
+## 快速导航
+
+| 文档 | 描述 |
+|----------|-------------|
+| [安装指南](installation_zh.md) | 如何在您的系统上安装 ASK |
+| [命令参考](commands_zh.md) | 完整的命令参考手册 |
+| [技能源](skill-sources_zh.md) | 理解和配置技能源 |
+| [技能格式](skill-format_zh.md) | 使用 SKILL.md 创建技能 |
+| [配置指南](configuration_zh.md) | ask.yaml 和 ask.lock 配置 |
+| [故障排除](troubleshooting_zh.md) | 常见问题与解决方案 |
+| [架构设计](architecture_zh.md) | 内部设计与结构 |
+| [Web 界面](web-ui_zh.md) | 可视化 Web 界面指南 |
+
+## 获取帮助
+
+- **GitHub Issues**: [报告 Bug 或请求新功能](https://github.com/yeasy/ask/issues)
+- **Discussions**: [提问和分享想法](https://github.com/yeasy/ask/discussions)
+
+## 贡献指南
+
+请参阅我们的 [贡献指南](../CONTRIBUTING.md) 以获取有关如何为 ASK 做贡献的信息。