adspecs 0.1.28 → 0.1.30

package/skills/adspecs-front-prototype/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-front-prototype"
 description: "基于 PRD 文件（或前端功能设计文档）+ front-demo 参考工程，生成可在 front-demo 中直接运行的完整页面原型（页面 + API + i18n 语言包 + 配置）。遵循 frontend-integration 规范（不存在时回退到 front-demo/.claude/rules/）。Use when the user asks to generate a frontend prototype, create demo pages from PRD, or build a working demo based on requirements."
+agent_created: true
 argument-hint: "<PRD 文件路径> [front-demo 目录路径]"
 compatibility: "需要 references/front-demo/ 参考工程；可选 references/docs/40-project_conventions/frontend-integration/ 规范"
 metadata:

package/skills/adspecs-front-spec/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-front-spec"
 description: "基于 PRD 文件和系统设计文档一次性完成前端交互和 UI 行为语义提取，生成面向产品经理和前端开发的功能规格说明书（UI/交互规格）"
+agent_created: true
 argument-hint: "指定 PRD 文件路径和系统设计文档文件路径，如 docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md"
 compatibility: "需要 docs/ 目录体系，含 04-前端功能设计模板.md、项目约定文档、ECP 编码规范"
 metadata:

package/skills/adspecs-front-tasks/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-front-tasks"
 description: "基于前端设计文档（_前端设计.md），为前端功能生成 TDD 就绪的、按依赖排序的 tasks.md 文件。支持 Vue + Element Plus / React + Ant Design 技术栈自动检测"
+agent_created: true
 argument-hint: "指定前端设计文档路径，如 docs/30-system-design/crm/M06-01_销售预测_前端设计.md"
 compatibility: "需要 docs/ 目录体系：docs/30-system-design（前端设计文档）+ .adspecs/templates（05b-前端任务清单模板）。支持 Vue + Element Plus 或 React + Ant Design 技术栈（自动检测），参考 references/front-demo/.claude/rules 或 references/ant6-front-standard"
 metadata:

package/skills/adspecs-git-commit/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-git-commit
 description: Adspecs 命令完成后自动提交更改
+agent_created: true
 compatibility: 需要 adspecs 项目结构及 docs/ 目录
 metadata:
   author: qing wen

package/skills/adspecs-git-initialize/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-git-initialize
 description: Initialize a Git repository with an initial commit
+agent_created: true
 compatibility: Requires adspecs project structure with .adspecs/ directory
 metadata:
   author: github-spec-kit

package/skills/adspecs-new-requirement/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-new-requirement"
 description: "基于业务需求描述，结合 01-业务需求分析模板（六步结构），完成深度需求分析并输出业务需求分析文档。Skill 内部执行模拟需求评审（多角色尖锐提问），评审结论融入最终决策。在写 PRD 之前，先搞清楚真正的问题是什么、为谁解决、怎么解决、有哪些风险。"
+agent_created: true
 argument-hint: "描述你要分析的业务需求，或指定已有需求文档路径"
 compatibility: "需要 docs/ 目录体系，含 01-业务需求分析模板.md"
 metadata:

package/skills/adspecs-plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-plan"
 description: "基于 PRD 文件一次性完成需求分析与系统设计（OOA+OOD），输出统一设计文档（_system-design.md）和建表 SQL（_schema.sql）"
+agent_created: true
 argument-hint: "指定 PRD 文件路径，如 docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md"
 compatibility: "需要 docs/ 目录体系，含 03-系统设计模板.md v1.2、项目后端编码规范（由 docs/40-project_conventions/end-integration/index.md 提供）"
 metadata:

package/skills/adspecs-prd/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-prd"
 description: "根据自然语言功能描述创建或更新功能规格说明书。"
+agent_created: true
 argument-hint: "描述你想要生成 spec 的功能"
 compatibility: "需要 adspecs 项目结构及 docs/ 目录"
 metadata:

package/skills/adspecs-prd-to-demo/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-prd-to-demo"
 description: "基于 PRD（或业务需求分析、前端功能设计文档）输出『可点击 Demo 设计方案』——7 段式规划文档（目标 / 页面清单 / 核心流程 / 页面内容 / 假数据 / 视觉风格 / AI Studio Prompt），用于直接喂给 AI Studio / Lovable / v0 / front-demo 原型工程生成可交互 Demo。不写代码，只做设计规划。Use when the user wants to plan a clickable product demo, design a prototype from a PRD, or prepare a prompt for AI Studio / Lovable."
+agent_created: true
 argument-hint: "<PRD 文件路径> [功能短名]"
 compatibility: "需要 adspecs 项目结构及 docs/ 目录；可选 references/front-demo/ 参考工程以增强视觉风格建议"
 metadata:

package/skills/adspecs-save-session/SKILL.md

@@ -1,178 +1,179 @@
----
-name: adspecs-save-session
-description: "保存当前 AI 会话为结构化 Markdown 日志。生成含摘要、产物清单、决策记录的 .log 文件到 docs/80-development/800-log/。Use when user asks to save session, log session, or before /clear."
-argument-hint: "[--summary-only]"
-user-invocable: true
-compatibility: 需要 .adspecs/ 目录结构
----
-
-# AI 会话日志保存
-
-将当前 Claude Code 会话内容生成结构化摘要，写入 `docs/80-development/800-log/` 目录下的 `.log` Markdown 文件。
-
-## 适用场景
-
-- 用户显式输入「保存会话」「记录会话」「save session」「log session」
-- 会话即将结束（任务完成、用户表示结束）
-- 长会话节点（完成系统设计、任务清单等重要阶段）
-- 用户执行 `/clear` 前
-- PreCompact 触发（上下文即将压缩）
-- 上次会话未保存的恢复场景
-
-## 用户输入
-
-```text
-$ARGUMENTS
-```
-
-### 参数说明
-
-| 参数 | 必填 | 说明 | 示例 |
-|------|------|------|------|
-| `--summary-only` | 否 | 仅生成 Summary，跳过 Key Artifacts 和 Decisions | `--summary-only` |
-
-## 执行步骤
-
-### 1. 读取配置
-
-读取以下文件（缺失时使用默认值）：
-
-- `.adspecs/paths.json` → `paths.session_log_dir`（默认 `docs/80-development/800-log`）
-- `.adspecs/feature.json` → `active` 字段（提取模块 ID）
-- `.adspecs/session-logger.json` → 用户自定义配置
-
-**模块 ID 提取规则**：
-- `active` 为空 → 使用 `GEN`
-- `active = docs/20-prd/003-user-auth` → 取末段 `003-user-auth`
-- 正则 `/^([a-z0-9]+(?:-[a-z0-9]+)*)/i` 提取编号前缀
-
-### 2. 计算文件名
-
-格式：`{YYYYMMDD-HHmmss}_{module-id}_ai-session.log`
-
-示例：
-- `20260730-143522_003-user-auth_ai-session.log`
-- `20260730-150000_GEN_ai-session.log`（无 active 模块时）
-- `20260730-160000_003-user-auth_ai-session-recovery.log`（恢复场景）
-
-### 3. 生成 Markdown 日志
-
-使用以下模板：
-
-```markdown
-# AI Session Log
-
-- Date: YYYY-MM-DD HH:mm:ss
-- Module: {id} ({name})
-- Trigger: manual | pre_compact | session_end | recovery
-- Duration: ~Nmin
-- Turns: N
-- Skills invoked: skill1, skill2, ...
-
-## Summary
-
-（200 字以内，实质性摘要，禁止空洞描述）
-
-**必须包含**：
-- 本次会话解决的核心问题
-- 关键决策及其理由
-- 重要产出物概述
-
-**禁止**：
-- "本次会话讨论了需求"等空洞描述
-- 重复用户问题
-- 无实质内容的总结
-
-## Key Artifacts
-
-- docs/20-prd/003-user-auth/003-user-auth_产品需求说明书.md (created)
-- docs/30-system-design/003-user-auth_system-design.md (created)
-- docs/30-system-design/003-user-auth_schema.sql (created)
-
-**规则**：
-- 列出本次会话创建或修改的真实文件路径
-- 每个文件标注 `(created)` 或 `(modified)`
-- 最多列出 20 个文件（按重要性排序）
-- 若使用 `--summary-only`，跳过此节
-
-## Decisions & Open Issues
-
-- [决策] 采用 JWT 而非 Session 认证，原因：无状态、易扩展
-- [决策] 数据库使用 PostgreSQL，理由：团队熟悉、JSON 支持好
-- [待定] 第三方 OAuth 接入范围待用户确认
-- [待定] 性能指标（QPS 目标）需与运维对齐
-
-**规则**：
-- `[决策]`：已确定的技术方案、架构选择、工具选型等
-- `[待定]`：未解决的问题、待确认的需求、待对齐的指标
-- 若使用 `--summary-only`，跳过此节
-```
-
-### 4. 写入文件
-
-使用 Write 工具将生成的 Markdown 内容写入计算出的文件路径。
-
-### 5. 更新 marker
-
-读取 `.claude/.session-save-marker`，更新以下字段：
-- `saved: true`
-- `saveCount: saveCount + 1`
-- `timestamp: 当前 ISO 时间戳`
-
-若 marker 不存在，创建新 marker：
-
-```json
-{
-  "type": "session_started",
-  "module": "{module-id}",
-  "moduleName": "{module-name}",
-  "timestamp": "ISO",
-  "startedAt": "ISO",
-  "saved": true,
-  "saveCount": 1,
-  "compactRequestedAt": null,
-  "missedAt": null
-}
-```
-
-### 6. 输出确认
-
-```
-[session-logger] Saved: {filename}
-[session-logger] Location: {logDir}/{filename}
-[session-logger] Save count: {saveCount}
-```
-
-## 多次保存规则
-
-同一会话可多次保存（时间戳区分文件）：
-
-- **第 1 次保存**：Summary 覆盖整个会话
-- **第 N 次保存**（N > 1）：Summary 聚焦「上次保存后的进展」
-- 每次保存的 Key Artifacts 列出**本次新增/修改**的文件
-
-通过 marker 的 `saveCount` 字段判断当前是第几次保存。
-
-## 恢复场景
-
-当 marker 文件存在且 `type == session_missed` 时：
-
-1. SessionStart 注入恢复提醒
-2. 用户确认恢复后，调用本 skill
-3. 文件名后缀加 `-recovery`（如 `20260730-160000_003-user-auth_ai-session-recovery.log`）
-4. Summary 基于用户描述的上次会话要点生成
-
-## 注意事项
-
-- Summary 必须实质性，禁止空洞描述
-- Key Artifacts 必须是真实存在的文件路径（可用 Glob 验证）
-- 日志文件使用 `.log` 扩展名（纯文本 Markdown）
-- 日志文件应纳入 git 跟踪（作为开发审计轨迹）
-- 若 `.adspecs/` 目录不存在，提示用户先执行 `/project-init`
-
-## 相关文件
-
-- `hooks/session-logger.js` — Hook 脚本（触发信号）
-- `.claude/.session-save-marker` — 状态 marker 文件
-- `.adspecs/session-logger.json` — 用户配置
-- `.adspecs/paths.json` — 路径配置
+---
+name: adspecs-save-session
+description: "保存当前 AI 会话为结构化 Markdown 日志。生成含摘要、产物清单、决策记录的 .log 文件到 docs/80-development/800-log/。Use when user asks to save session, log session, or before /clear."
+agent_created: true
+argument-hint: "[--summary-only]"
+user-invocable: true
+compatibility: 需要 .adspecs/ 目录结构
+---
+
+# AI 会话日志保存
+
+将当前 Claude Code 会话内容生成结构化摘要，写入 `docs/80-development/800-log/` 目录下的 `.log` Markdown 文件。
+
+## 适用场景
+
+- 用户显式输入「保存会话」「记录会话」「save session」「log session」
+- 会话即将结束（任务完成、用户表示结束）
+- 长会话节点（完成系统设计、任务清单等重要阶段）
+- 用户执行 `/clear` 前
+- PreCompact 触发（上下文即将压缩）
+- 上次会话未保存的恢复场景
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+### 参数说明
+
+| 参数 | 必填 | 说明 | 示例 |
+|------|------|------|------|
+| `--summary-only` | 否 | 仅生成 Summary，跳过 Key Artifacts 和 Decisions | `--summary-only` |
+
+## 执行步骤
+
+### 1. 读取配置
+
+读取以下文件（缺失时使用默认值）：
+
+- `.adspecs/paths.json` → `paths.session_log_dir`（默认 `docs/80-development/800-log`）
+- `.adspecs/feature.json` → `active` 字段（提取模块 ID）
+- `.adspecs/session-logger.json` → 用户自定义配置
+
+**模块 ID 提取规则**：
+- `active` 为空 → 使用 `GEN`
+- `active = docs/20-prd/003-user-auth` → 取末段 `003-user-auth`
+- 正则 `/^([a-z0-9]+(?:-[a-z0-9]+)*)/i` 提取编号前缀
+
+### 2. 计算文件名
+
+格式：`{YYYYMMDD-HHmmss}_{module-id}_ai-session.log`
+
+示例：
+- `20260730-143522_003-user-auth_ai-session.log`
+- `20260730-150000_GEN_ai-session.log`（无 active 模块时）
+- `20260730-160000_003-user-auth_ai-session-recovery.log`（恢复场景）
+
+### 3. 生成 Markdown 日志
+
+使用以下模板：
+
+```markdown
+# AI Session Log
+
+- Date: YYYY-MM-DD HH:mm:ss
+- Module: {id} ({name})
+- Trigger: manual | pre_compact | session_end | recovery
+- Duration: ~Nmin
+- Turns: N
+- Skills invoked: skill1, skill2, ...
+
+## Summary
+
+（200 字以内，实质性摘要，禁止空洞描述）
+
+**必须包含**：
+- 本次会话解决的核心问题
+- 关键决策及其理由
+- 重要产出物概述
+
+**禁止**：
+- "本次会话讨论了需求"等空洞描述
+- 重复用户问题
+- 无实质内容的总结
+
+## Key Artifacts
+
+- docs/20-prd/003-user-auth/003-user-auth_产品需求说明书.md (created)
+- docs/30-system-design/003-user-auth_system-design.md (created)
+- docs/30-system-design/003-user-auth_schema.sql (created)
+
+**规则**：
+- 列出本次会话创建或修改的真实文件路径
+- 每个文件标注 `(created)` 或 `(modified)`
+- 最多列出 20 个文件（按重要性排序）
+- 若使用 `--summary-only`，跳过此节
+
+## Decisions & Open Issues
+
+- [决策] 采用 JWT 而非 Session 认证，原因：无状态、易扩展
+- [决策] 数据库使用 PostgreSQL，理由：团队熟悉、JSON 支持好
+- [待定] 第三方 OAuth 接入范围待用户确认
+- [待定] 性能指标（QPS 目标）需与运维对齐
+
+**规则**：
+- `[决策]`：已确定的技术方案、架构选择、工具选型等
+- `[待定]`：未解决的问题、待确认的需求、待对齐的指标
+- 若使用 `--summary-only`，跳过此节
+```
+
+### 4. 写入文件
+
+使用 Write 工具将生成的 Markdown 内容写入计算出的文件路径。
+
+### 5. 更新 marker
+
+读取 `.claude/.session-save-marker`，更新以下字段：
+- `saved: true`
+- `saveCount: saveCount + 1`
+- `timestamp: 当前 ISO 时间戳`
+
+若 marker 不存在，创建新 marker：
+
+```json
+{
+  "type": "session_started",
+  "module": "{module-id}",
+  "moduleName": "{module-name}",
+  "timestamp": "ISO",
+  "startedAt": "ISO",
+  "saved": true,
+  "saveCount": 1,
+  "compactRequestedAt": null,
+  "missedAt": null
+}
+```
+
+### 6. 输出确认
+
+```
+[session-logger] Saved: {filename}
+[session-logger] Location: {logDir}/{filename}
+[session-logger] Save count: {saveCount}
+```
+
+## 多次保存规则
+
+同一会话可多次保存（时间戳区分文件）：
+
+- **第 1 次保存**：Summary 覆盖整个会话
+- **第 N 次保存**（N > 1）：Summary 聚焦「上次保存后的进展」
+- 每次保存的 Key Artifacts 列出**本次新增/修改**的文件
+
+通过 marker 的 `saveCount` 字段判断当前是第几次保存。
+
+## 恢复场景
+
+当 marker 文件存在且 `type == session_missed` 时：
+
+1. SessionStart 注入恢复提醒
+2. 用户确认恢复后，调用本 skill
+3. 文件名后缀加 `-recovery`（如 `20260730-160000_003-user-auth_ai-session-recovery.log`）
+4. Summary 基于用户描述的上次会话要点生成
+
+## 注意事项
+
+- Summary 必须实质性，禁止空洞描述
+- Key Artifacts 必须是真实存在的文件路径（可用 Glob 验证）
+- 日志文件使用 `.log` 扩展名（纯文本 Markdown）
+- 日志文件应纳入 git 跟踪（作为开发审计轨迹）
+- 若 `.adspecs/` 目录不存在，提示用户先执行 `/project-init`
+
+## 相关文件
+
+- `hooks/session-logger.js` — Hook 脚本（触发信号）
+- `.claude/.session-save-marker` — 状态 marker 文件
+- `.adspecs/session-logger.json` — 用户配置
+- `.adspecs/paths.json` — 路径配置

package/skills/adspecs-tasks/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-tasks"
 description: "基于统一系统设计文档（_system-design.md），为项目功能生成 TDD 就绪的、按依赖排序的 tasks.md 文件"
+agent_created: true
 argument-hint: "指定系统设计文档路径，如 docs/30-system-design/crm/M06-01-销售预测_system-design.md"
 compatibility: "需要 adspecs 项目结构，含 adspecs/ 目录 + CLAUDE.md + docs/30-system-design + .adspecs/templates + docs/40-project_conventions/end-integration/index.md"
 metadata:

package/skills/adspecs-update-status/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-update-status
 description: "更新 .adspecs/feature.json 中各阶段数组的功能状态值。首次执行时输出功能追踪矩阵（各功能所处阶段、状态、创建时间及汇总统计）。支持 requirement、prd、frontDemos、endDesigns、frontDesigns、endCodes、unitTests、situationTests、uats、deploys 十类数组。Use when the user asks to update feature status, change stage status, mark requirement as reviewed, or update feature.json status."
+agent_created: true
 argument-hint: "[<功能ID> <状态值>] [--category <数组类别>] [--list]"
 user-invocable: true
 ---

package/skills/adspecs-utest/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-utest
 description: "基于后端系统设计文档，生成 Service 层 / Controller 层单元测试代码，并按模板输出单元测试报告"
+agent_created: true
 argument-hint: "指定功能名或系统设计文档路径，如 M06-01 或 docs/30-system-design/crm/M06-01-销售预测_system-design.md"
 compatibility: "需要 docs/ 目录体系：docs/20-prd（PRD）+ docs/30-system-design（系统设计+tasks）+ CLAUDE.md + docs/40-project_conventions/end-integration/index.md"
 metadata:

package/skills/adspecs-write-planning-report/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-write-planning-report
 description: 汇总调研期所有分析输出，生成完整产品规划报告并落盘到 docs/00-planning/，是规划期的核心必选节点。
+agent_created: true
 ---
 
 # Skill: adspecs-write-planning-report

package/skills/adspecs-write-roadmap/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: adspecs-write-roadmap
 description: 人工审批通过后，将规划报告中的版本节奏建议追写/更新到 docs/00-planning/roadmap.md，完成调研规划期的最终输出。
+agent_created: true
 ---
 
 # Skill: adspecs-write-roadmap

package/skills/adspecs-write-sow/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: "adspecs-write-sow"
 description: "根据项目信息、合同要点与实施范围创建或更新工作说明书（SOW）。"
+agent_created: true
 argument-hint: "描述项目背景、甲乙方、实施范围与关键约定"
 compatibility: "需要 adspecs 项目结构及 docs/ 目录"
 metadata:

package/skills/grill-me/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: grill-me
 description: A relentless interview to sharpen a plan or design.
+agent_created: true
 disable-model-invocation: true
 ---
 

package/skills/playwright-cli/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: playwright-cli
 description: Automate browser interactions, test web pages and work with Playwright tests.
+agent_created: true
 allowed-tools: Bash(playwright-cli:*) Bash(npx:*) Bash(npm:*)
 ---
 

package/skills/playwright-trace/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: playwright-trace
 description: Inspect Playwright trace files from the command line — list actions, view requests, console, errors, snapshots and screenshots.
+agent_created: true
 allowed-tools: Bash(npx:*)
 ---
 

package/skills/project-init/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: project-init
 description: "初始化项目目录结构，收集项目元信息（项目名称、目录、公司、密级），生成 .adspecs/project.json。支持四种模式：简易模式（仅 docs + wiki）、经典模式（+ front-demo）、完整模式（所有目录）、轻量模式（Python+SQLite+React+AntD6 全栈 demo，固定技术栈）。经典/完整模式支持 front-demo 技术栈选择（Vue 或 Ant Design React）。项目目录可选：未提供时直接在当前工作目录创建。Use when the user asks to initialize a project, create project scaffold, set up a new development environment, or recreate the project directory structure."
+agent_created: true
 argument-hint: "[--project-name <名称>] [--project-dir <目录>] [--company <公司>] [--mode simple|classic|full|demo] [--front-demo vue|antd]"
 ---
 

package/skills/sie-front-code-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sie-front-code-review
 description: 基于前端编码规范执行 React + TypeScript + Ant Design 项目的代码评审，输出按严重级别排序的问题清单与修复建议
+agent_created: true
 ---
 
 # Sie Front Code Review