cdspec 0.1.0 → 0.1.3

package/templates/{frontend-develop-standard → frontend-standard}/SKILL.md

@@ -1,63 +1,63 @@
----
-name: frontend-standards
-description: 部门级前端开发规范执行技能，覆盖 Vue3 编码规范、工程配置规范、Git 提交规范与前端最佳实践。用于前端需求开发、重构、代码评审、工程初始化与联调前自检；当任务涉及 Vue3/TypeScript 页面与组件实现、样式规范、ESLint/Prettier/Husky/Commitlint 配置时触发。
----
-
-# 部门前端开发规范技能
-
-## 总体目标
-
-在实现前端需求时，优先保证可维护性、一致性与可扩展性，避免临时方案累积技术债务。先明确需求边界与页面职责，再按规范完成编码、样式、工程配置与提交自检。
-
-## 增量开发优先级
-
-针对系统开发中的增量工作，按以下优先级执行：
-
-1. 业务需求与用户明确指令（最高优先级）。
-2. 项目既有规范与代码风格（默认优先遵循）。
-3. 本技能与通用前端规范（用于补充与兜底）。
-
-冲突处理原则：
-
-- 不冲突时：遵循项目现有风格，本技能作为检查清单。
-- 存在冲突时：以项目既有风格为准，避免在本次需求中做大范围风格迁移。
-- 涉及安全、严重缺陷或团队已达成统一升级决策时，可在说明影响范围后做规范升级。
-
-## 执行流程
-
-1. 识别任务类型与范围。
-
-- 若为页面/组件开发，重点执行 Vue3 组件规范、命名规范、样式作用域规范。
-- 若为工程治理任务，重点执行 EditorConfig、Prettier、ESLint、Husky、Commitlint 配置规范。
-- 若用户已指定现有项目约束，以用户约束优先，在不冲突前提下遵循本技能。
-
-2. 加载参考规范并制定实现方案。
-
-- 始终加载 `references/frontend_develop_standard.md`。
-- 若任务仅涉及局部改动，只应用与改动相关的条目，避免过度改造。
-
-3. 编码与配置时强制执行。
-
-- 命名语义化：组件、变量、常量、类型命名遵循规范。
-- 统一代码风格：模板双引号、脚本单引号、多属性换行。
-- 样式默认使用作用域（`scoped`），穿透样式使用 `:deep()`。
-- 禁止保留 `console.log`、`debugger` 和无效注释代码。
-- 事件与处理函数命名保持一致（如 `on-*`、`handle*`）。
-
-4. 交付前执行自检。
-
-- 检查格式化与 lint 规则是否一致。
-- 检查组件职责是否清晰、是否存在可复用代码未抽离。
-- 检查性能与安全风险（如不必要渲染、`v-html`、输入校验缺失）。
-- 检查提交信息是否符合约定式提交规范。
-
-## 交付要求
-
-1. 明确说明本次改动遵循的前端规范条目（至少包含命名、样式、质量自检中的关键项）。
-2. 若涉及工程配置，列出新增或调整的配置文件与关键配置项。
-3. 若涉及组件开发，说明组件职责、事件约定与样式边界处理方式。
-4. 输出遗留风险与后续建议，避免把隐患留给后续维护者。
-
-## 参考资料
-
-- `references/frontend_develop_standard.md`
+---
+name: frontend-standard
+description: 部门级前端开发规范执行技能，覆盖 Vue3 编码规范、工程配置规范、Git 提交规范与前端最佳实践。用于前端需求开发、重构、代码评审、工程初始化与联调前自检；当任务涉及 Vue3/TypeScript 页面与组件实现、样式规范、ESLint/Prettier/Husky/Commitlint 配置时触发。
+---
+
+# 部门前端开发规范技能
+
+## 总体目标
+
+在实现前端需求时，优先保证可维护性、一致性与可扩展性，避免临时方案累积技术债务。先明确需求边界与页面职责，再按规范完成编码、样式、工程配置与提交自检。
+
+## 增量开发优先级
+
+针对系统开发中的增量工作，按以下优先级执行：
+
+1. 业务需求与用户明确指令（最高优先级）。
+2. 项目既有规范与代码风格（默认优先遵循）。
+3. 本技能与通用前端规范（用于补充与兜底）。
+
+冲突处理原则：
+
+- 不冲突时：遵循项目现有风格，本技能作为检查清单。
+- 存在冲突时：以项目既有风格为准，避免在本次需求中做大范围风格迁移。
+- 涉及安全、严重缺陷或团队已达成统一升级决策时，可在说明影响范围后做规范升级。
+
+## 执行流程
+
+1. 识别任务类型与范围。
+
+- 若为页面/组件开发，重点执行 Vue3 组件规范、命名规范、样式作用域规范。
+- 若为工程治理任务，重点执行 EditorConfig、Prettier、ESLint、Husky、Commitlint 配置规范。
+- 若用户已指定现有项目约束，以用户约束优先，在不冲突前提下遵循本技能。
+
+2. 加载参考规范并制定实现方案。
+
+- 始终加载 `references/frontend_standard.md`。
+- 若任务仅涉及局部改动，只应用与改动相关的条目，避免过度改造。
+
+3. 编码与配置时强制执行。
+
+- 命名语义化：组件、变量、常量、类型命名遵循规范。
+- 统一代码风格：模板双引号、脚本单引号、多属性换行。
+- 样式默认使用作用域（`scoped`），穿透样式使用 `:deep()`。
+- 禁止保留 `console.log`、`debugger` 和无效注释代码。
+- 事件与处理函数命名保持一致（如 `on-*`、`handle*`）。
+
+4. 交付前执行自检。
+
+- 检查格式化与 lint 规则是否一致。
+- 检查组件职责是否清晰、是否存在可复用代码未抽离。
+- 检查性能与安全风险（如不必要渲染、`v-html`、输入校验缺失）。
+- 检查提交信息是否符合约定式提交规范。
+
+## 交付要求
+
+1. 明确说明本次改动遵循的前端规范条目（至少包含命名、样式、质量自检中的关键项）。
+2. 若涉及工程配置，列出新增或调整的配置文件与关键配置项。
+3. 若涉及组件开发，说明组件职责、事件约定与样式边界处理方式。
+4. 输出遗留风险与后续建议，避免把隐患留给后续维护者。
+
+## 参考资料
+
+- `references/frontend_standard.md`

package/templates/frontend-standard/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Frontend Standard"
+  short_description: "Generated from templates/frontend_standard.md"
+  default_prompt: "Use $frontend-standard to follow this template skill."

package/templates/{frontend-develop-standard/references/frontend_develop_standard.md → frontend-standard/references/frontend_standard.md}

@@ -7,19 +7,19 @@
 #### 1.1.1 组件命名
 
 **文件夹和文件名**
+
 - 使用小驼峰命名法（camelCase）
 - 示例：`testList/testList.vue`
 
 **组件引用**
+
 ```vue
 <template>
   <!-- 自闭合组件 -->
   <test-component />
 
   <!-- 包含内容的组件 -->
-  <container-component>
-    This is content
-  </container-component>
+  <container-component> This is content </container-component>
 </template>
 
 <script setup>
@@ -31,10 +31,11 @@ import ContainerComponent from './components/ContainerComponent.vue'
 #### 1.1.2 变量和常量命名
 
 **变量命名**
+
 - 使用小驼峰命名法（camelCase）
 - 语义化，见名知意
 
-```javascript
+```vue
 // 推荐
 let userInfo = {}
 let infoList = []
@@ -46,10 +47,11 @@ let data = []
 ```
 
 **常量命名**
+
 - 使用全大写字母，单词间用下划线分隔
 - 语义化，见名知意
 
-```javascript
+```vue
 // 推荐
 const MAX_NUMBER = 10
 const API_BASE_URL = 'https://api.example.com'
@@ -87,7 +89,7 @@ export interface CStateParams extends CState {
 #### 1.2.1 引号使用规范
 
 - HTML 属性使用双引号 `""`
-- JavaScript 代码使用单引号 `''`
+- vue 代码使用单引号 `''`
 
 ```vue
 <template>
@@ -106,20 +108,9 @@ const message = 'This is a message'
 
 ```vue
 <template>
-  <a-table-column
-    data-index="name"
-    title="名称"
-    :width="180"
-    align="center"
-    :sorter="true"
-  />
-
-  <li
-    v-for="(item, index) in testList"
-    :key="index"
-    :span="4"
-    style="margin-bottom: 10px"
-  >
+  <a-table-column data-index="name" title="名称" :width="180" align="center" :sorter="true" />
+
+  <li v-for="(item, index) in testList" :key="index" :span="4" style="margin-bottom: 10px">
     {{ item.name }}
   </li>
 </template>
@@ -213,11 +204,11 @@ onUnmounted(() => {
 </template>
 
 <script setup>
-const handleChange = (value) => {
+const handleChange = value => {
   console.log('value changed:', value)
 }
 
-const handleSubmit = (data) => {
+const handleSubmit = data => {
   console.log('form submitted:', data)
 }
 </script>
@@ -261,14 +252,14 @@ const onSubmit = () => {
 
 #### 1.4.2 脚本注释
 
-```javascript
+```vue
 // 删除用户
-const deleteUser = (id) => {
+const deleteUser = id => {
   // 实现逻辑
 }
 
 // 新增用户
-const addUser = (userData) => {
+const addUser = userData => {
   // 实现逻辑
 }
 
@@ -288,11 +279,12 @@ const updateUser = async (id, userData) => {
 #### 1.5.1 移除调试代码
 
 提交代码前必须移除：
+
 - `console.log()`
 - `debugger`
 - 注释掉的无用代码
 
-```javascript
+```vue
 // ❌ 不推荐
 const fetchData = () => {
   console.log('fetching data...')
@@ -313,13 +305,7 @@ const fetchData = () => {
 <template>
   <div class="user-form">
     <a-card>
-      <a-form
-        ref="formRef"
-        :model="formState"
-        :rules="rules"
-        :label-col="{ span: 4 }"
-        :wrapper-col="{ span: 20 }"
-      >
+      <a-form ref="formRef" :model="formState" :rules="rules" :label-col="{ span: 4 }" :wrapper-col="{ span: 20 }">
         <!-- 名称 -->
         <a-form-item label="名称" name="name">
           <a-input v-model:value="formState.name" placeholder="请输入名称" />
@@ -327,27 +313,19 @@ const fetchData = () => {
 
         <!-- 标签 -->
         <a-form-item label="标签" name="label">
-          <a-button type="link" @click="addLabel">
-            +添加一行
-          </a-button>
+          <a-button type="link" @click="addLabel"> +添加一行 </a-button>
           <span>(最多 20 个标签)</span>
         </a-form-item>
 
         <!-- 描述 -->
         <a-form-item label="描述" name="describe">
-          <a-textarea
-            v-model:value="formState.describe"
-            :rows="2"
-            placeholder="请输入描述"
-          />
+          <a-textarea v-model:value="formState.describe" :rows="2" placeholder="请输入描述" />
         </a-form-item>
 
         <!-- 操作按钮 -->
         <a-form-item :wrapper-col="{ offset: 4, span: 20 }">
           <a-button @click="handleCancel">取消</a-button>
-          <a-button type="primary" @click="handleSubmit" style="margin-left: 10px">
-            确认
-          </a-button>
+          <a-button type="primary" @click="handleSubmit" style="margin-left: 10px"> 确认 </a-button>
         </a-form-item>
       </a-form>
     </a-card>
@@ -378,9 +356,7 @@ const formState = reactive({
 
 // 表单验证规则
 const rules: Record<string, Rule[]> = {
-  name: [
-    { required: true, message: '请输入设备名称', trigger: 'blur' }
-  ]
+  name: [{ required: true, message: '请输入设备名称', trigger: 'blur' }]
 }
 
 // 新增标签
@@ -447,285 +423,16 @@ const handleSubmit = async () => {
 </style>
 ```
 
----
-
-## 二、项目配置规范
-
-### 2.1 EditorConfig 配置
-
-EditorConfig 帮助团队维护一致的编码风格。
-
-在项目根目录创建 `.editorconfig` 文件：
-
-```ini
-# http://editorconfig.org
-
-root = true
-
-[*]
-charset = utf-8
-indent_style = space
-indent_size = 2
-end_of_line = lf
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-max_line_length = off
-trim_trailing_whitespace = false
-```
-
-**配置说明：**
-- `charset`: 文件字符集为 UTF-8
-- `indent_style`: 缩进风格（space 或 tab）
-- `indent_size`: 缩进大小为 2 个空格
-- `end_of_line`: 换行符类型（lf、cr 或 crlf）
-- `trim_trailing_whitespace`: 去除行尾空白字符
-- `insert_final_newline`: 文件末尾插入新行
-
-**VSCode 插件：** 需安装 `EditorConfig for VS Code`
-
-### 2.2 Prettier 配置
-
-Prettier 是强大的代码格式化工具，支持多种前端语言。
-
-在项目根目录创建 `.prettierrc` 文件：
-
-```json
-{
-  "useTabs": false,
-  "tabWidth": 2,
-  "printWidth": 80,
-  "singleQuote": true,
-  "trailingComma": "none",
-  "semi": false
-}
-```
-
-**配置说明：**
-
-| 属性 | 说明 |
-|------|------|
-| useTabs | false: 使用空格缩进，true: 使用 tab 缩进 |
-| tabWidth | 缩进空格数，设置为 2 |
-| printWidth | 单行最大字符数，推荐 80 或 100 |
-| singleQuote | true: 使用单引号，false: 使用双引号 |
-| trailingComma | 多行输入尾逗号，设置为 none |
-| semi | false: 不加分号，true: 加分号 |
-
-**VSCode 插件：** 需安装 `Prettier - Code formatter`
-
-**常见问题：**
-
-1. **保存代码无法格式化**
-   - 原因：未设置默认格式化插件
-   - 解决：右键 → 格式化文档 → 选择 Prettier
-
-2. **保存无法自动格式化**
-   - 原因：未开启保存时格式化
-   - 解决：文件 → 设置 → 搜索 "Format On Save" → 勾选
-
-**快速格式化所有文件：**
-
-在 `package.json` 添加脚本：
-
-```json
-{
-  "scripts": {
-    "prettier": "prettier --write ."
-  }
-}
-```
-
-运行命令：
-
-```bash
-npm run prettier
-```
-
-### 2.3 Prettier 忽略配置
-
-在项目根目录创建 `.prettierignore` 文件：
-
-```
-/dist/*
-.local
-.output.js
-/node_modules/**
-**/*.svg
-**/*.sh
-/public/*
-```
-
-### 2.4 ESLint 配置
-
-Vue 项目创建时会自动配置 ESLint。
-
-**VSCode 插件：** 需安装 `ESLint`
-
-**解决 ESLint 和 Prettier 冲突：**
-
-安装插件（Vue 创建项目时选择 Prettier 会自动安装）：
-
-```bash
-npm install eslint-plugin-prettier eslint-config-prettier -D
-```
-
-在 `.eslintrc.js` 文件的 `extends` 中添加：
-
-```javascript
-module.exports = {
-  extends: [
-    // ... 其他配置
-    'plugin:prettier/recommended'
-  ]
-}
-```
-
-**注意：** `plugin:` 和 `prettier` 之间没有空格
-
----
-
-## 三、Git 提交规范
-
-### 3.1 Husky 配置
-
-Husky 用于在 Git 操作时触发钩子。
-
-**安装 Husky：**
-
-```bash
-npm install husky -D
-```
-
-**配置 prepare 脚本：**
-
-```bash
-npm set-script prepare "husky install"
-npm run prepare
-```
-
-**添加 pre-commit 钩子：**
-
-```bash
-npx husky add .husky/pre-commit "npx eslint ./"
-```
-
-如果自动生成失败，手动创建 `.husky/pre-commit` 文件：
-
-```bash
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx eslint ./
-```
-
-### 3.2 Commitlint 配置
-
-**安装 Commitlint：**
-
-```bash
-npm install --save-dev @commitlint/config-conventional @commitlint/cli
-```
-
-**创建配置文件：**
-
-```bash
-echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
-```
-
-**注意：** 确保文件编码为 UTF-8
-
-**添加 commit-msg 钩子：**
-
-```bash
-npx husky add .husky/commit-msg "npx --no -- commitlint --edit ${1}"
-```
-
-如果自动生成失败，手动创建 `.husky/commit-msg` 文件：
-
-```bash
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx --no-install commitlint --edit $1
-```
-
-**禁用 Husky（如需要）：**
-
-在 `.git/config` 文件中注释掉：
-
-```
-# hooksPath = .husky
-```
-
-### 3.3 Commit 提交规范
-
-**提交类型说明：**
-
-| 类型 | 说明 |
-|------|------|
-| feat | 新增功能 |
-| fix | 修复 Bug |
-| docs | 文档更新 |
-| style | 代码格式调整（不影响功能） |
-| refactor | 代码重构 |
-| perf | 性能优化 |
-| test | 测试相关 |
-| chore | 构建过程或辅助工具的变动 |
-| revert | 回滚提交 |
-| build | 影响构建系统或外部依赖 |
-| ci | CI 配置文件和脚本的变动 |
-| types | 类型定义文件更改 |
-| wip | 开发中（work in progress） |
-
-**提交格式：**
-
-```bash
-git commit -m "type: description"
-```
-
-**示例：**
-
-```bash
-# 新增功能
-git commit -m "feat: 添加用户登录功能"
-
-# 修复 Bug
-git commit -m "fix: 修复用户列表分页问题"
-
-# 文档更新
-git commit -m "docs: 更新 API 文档"
-
-# 代码重构
-git commit -m "refactor: 重构用户模块代码结构"
-
-# 性能优化
-git commit -m "perf: 优化列表渲染性能"
-```
-
-**完整格式（可选）：**
-
-```bash
-git commit -m "feat: 添加用户登录功能
-
-- 实现用户名密码登录
-- 添加记住密码功能
-- 集成第三方登录"
-```
-
----
-
-## 四、最佳实践建议
+## 二、最佳实践建议
 
-### 4.1 代码组织
+### 2.1 代码组织
 
 - 按功能模块组织代码，而非按文件类型
 - 保持组件单一职责
 - 合理拆分大型组件
 - 复用性高的代码抽取为公共组件或工具函数
 
-### 4.2 性能优化
+### 2.2 性能优化
 
 - 合理使用 `v-if` 和 `v-show`
 - 列表渲染使用唯一 `key`
@@ -733,14 +440,14 @@ git commit -m "feat: 添加用户登录功能
 - 使用 `computed` 缓存计算结果
 - 大型列表使用虚拟滚动
 
-### 4.3 安全规范
+### 2.3 安全规范
 
 - 避免使用 `v-html`，防止 XSS 攻击
 - 敏感信息不要硬编码在前端
 - API 请求添加适当的权限验证
 - 用户输入进行验证和过滤
 
-### 4.4 可维护性
+### 2.4 可维护性
 
 - 编写清晰的注释
 - 保持代码简洁易读

package/AGENTS.md

@@ -1,14 +0,0 @@
-# AGENTS instructions
-
-<INSTRUCTIONS>
-## OpenSpec Setup
-Enabled targets: codex
-### Skills
-- design-doc: 管理业务详细设计文档的全生命周期：首次基线、增量 feature 文档、归档合并。适用于首次开发与迭代改造，避免小改动频繁新建基线版本文件，同时保留 feature 变更历史。
-- frontend-standards: 部门级前端开发规范执行技能，覆盖 Vue3 编码规范、工程配置规范、Git 提交规范与前端最佳实践。用于前端需求开发、重构、代码评审、工程初始化与联调前自检；当任务涉及 Vue3/TypeScript 页面与组件实现、样式规范、ESLint/Prettier/Husky/Commitlint 配置时触发。
-- standards-backend: 部门级后端开发规范执行技能，覆盖后端编码规范、数据库设计规范、传统三层架构约束、DDD架构约束、常用设计模式落地与JUC并发编排规范，并内置数据表基线字段与关联表例外规则。用于需求开发、重构、代码评审、建表SQL设计、接口设计、并发优化与联调前自检等场景；当任务涉及 Java 后端实现、SQL/表结构、分层落位、架构选型（三层或DDD）、可扩展性设计（策略/工厂/责任链/适配器/模板/单例）或线程池/CompletableFuture/CountDownLatch/Semaphore/ReentrantLock/Atomic* 等并发处理时触发。
-### Command Bindings
-- cd-design-doc -> design-doc
-- cd-frontend-standards -> frontend-standards
-- cd-standards-backend -> standards-backend
-</INSTRUCTIONS>

package/CLAUDE.md

@@ -1,10 +0,0 @@
-# claudecode OpenSpec-style setup
-
-## Installed skills
-- frontend-develop-standard: Generated from templates/frontend_develop_standard.md
-
-## Commands
-- /opsx:propose -> frontend-develop-standard
-- /opsx:explore -> frontend-develop-standard
-- /opsx:apply -> frontend-develop-standard
-- /opsx:archive -> frontend-develop-standard

package/dist/skill-core/agent-config.js

@@ -1,40 +0,0 @@
-import { basename, join } from "node:path";
-import { writeFile } from "node:fs/promises";
-import { ensureDir } from "../utils/fs.js";
-const CONFIG_FILE_BY_TARGET = {
-    codex: "AGENTS.md",
-    claudecode: "CLAUDE.md",
-    iflow: "IFLOW.md"
-};
-export async function writeAgentConfig(cwd, target, skills) {
-    await ensureDir(cwd);
-    const filename = CONFIG_FILE_BY_TARGET[target];
-    const filePath = join(cwd, filename);
-    const content = renderConfig(target, skills);
-    await writeFile(filePath, content, "utf8");
-    return filePath;
-}
-function renderConfig(target, skills) {
-    const title = `# ${filenameForTarget(target)} instructions`;
-    const lines = [title, "", "<INSTRUCTIONS>", "## Skills"];
-    lines.push("A skill is a local capability package. The list below is generated by `cdspec init`.");
-    lines.push("### Available skills");
-    if (skills.length === 0) {
-        lines.push("- (none)");
-    }
-    else {
-        for (const skill of skills) {
-            const desc = skill.description || "No description.";
-            lines.push(`- ${skill.name}: ${desc} (file: skills/${target}/${skill.name}/SKILL.md)`);
-        }
-    }
-    lines.push("### How to use");
-    lines.push("- Mention the skill name in your request, or use `/use <skill-name>`.");
-    lines.push("- In Codex, `$<skill-name>` is also supported.");
-    lines.push("- Skills are project-local and loaded from the generated `skills/` folder.");
-    lines.push("</INSTRUCTIONS>", "");
-    return lines.join("\n");
-}
-function filenameForTarget(target) {
-    return basename(CONFIG_FILE_BY_TARGET[target], ".md").toUpperCase();
-}