@shendu-sdt/sdt-dev-agent 0.1.2 → 0.1.3-beta.20260519142550

package/README.md

@@ -1,14 +1,21 @@
 # SDT DevAgent
 
-面向研发项目的全局 CLI，用于给现有仓库落地 AI 协作底座。
+面向研发项目的全局 CLI，用于给现有仓库安装项目级 AI 协作接入能力。
 
-当前版本提供一个初始化命令：
+当前版本提供以下命令：
 
 ```bash
 sdt-dev-agent init [targetPath]
+sdt-dev-agent status [targetPath]
+sdt-dev-agent list skills
+sdt-dev-agent list mcp
+sdt-dev-agent list workflows
+sdt-dev-agent add skill <name>
+sdt-dev-agent add mcp <name>
+sdt-dev-agent add workflow <name>
 ```
 
-它会把项目级 AI 协作文档骨架、工具占位目录、能力包占位目录，以及安装清单 `.sdt-devagent/manifest.json` 安装到现有仓库中。
+它会围绕 bootstrap skill、项目级 skills、项目级 MCP、workflow 和安装清单来初始化或增量管理目标项目。
 
 ## Quick Start
 
@@ -33,24 +40,71 @@ sdt-dev-agent init .
 sdt-dev-agent init . --yes
 ```
 
+## Supported Tools
+
 当前支持：
 
 - tools: `codex`, `claude-code`
-- install mode: `recommended`, `minimal`, `custom`
-- capabilities: `base-assets`, `skills`, `mcp`
+- install mode: `recommended`, `custom`
+
+## Built-in Capabilities
+
+当前命令面只处理三类 capability：
+
+- `skills`
+- `mcp`
+- `workflows`
+
+当前内置能力可以概括为：
+
+- `skills`
+  - 必装 bootstrap skill：`bootstrap-project-docs`
+  - 内置推荐远端 skills，可按 `recommended` 或 `custom` 安装
+- `mcp`
+  - 默认 MCP：`Context7`
+  - 选装 MCP：`MasterGo`
+- `workflows`
+  - 独立 workflow：`OpenSpec`
+  - 不会混入普通 `skill`；使用 `list workflows` / `add workflow` 管理
 
 初始化输出包括：
 
-- `AGENTS.md`
-- `ARCHITECTURE.md`
-- `docs/ai-collaboration/README.md`
-- `.codex/` / `.claude/` 占位文件
+- 根级前置入口文档：`AGENTS.md` / `CLAUDE.md`
+- `.sdt-devagent/bootstrap-project-docs.md`
+- 必装 bootstrap skill：`bootstrap-project-docs`
+- `Codex` / `Claude Code` 的项目级 hooks 增强配置
+- 远端推荐 skills 的项目级安装结果
+- `Context7` / `MasterGo` 的项目级 MCP 配置
 - `.sdt-devagent/manifest.json`
 
+## Discover And Install
+
+查看当前内置项：
+
+```bash
+sdt-dev-agent list skills
+sdt-dev-agent list mcp
+sdt-dev-agent list workflows
+```
+
+增量安装：
+
+```bash
+sdt-dev-agent add skill <name>
+sdt-dev-agent add mcp <name>
+sdt-dev-agent add workflow <name>
+```
+
 > [!NOTE]
-> 当前只支持初始化基座，不包含真实 MCP 接线、真实 Skills 内容或业务闭环。
+> 当前只支持 `Codex` / `Claude Code` 的项目级接入，不包含业务任务编排、PR/发布流或服务端能力。
+>
+> 重复执行 `init` 时，CLI 托管的 bootstrap 入口文件和 manifest 会按最新模板直接覆盖；用户已有 `AGENTS.md` / `CLAUDE.md` 会保留并提示人工合并。
+>
+> 如果项目层已经存在 `.codex/hooks.json`，CLI 不会再把托管 hooks 混写进同层 `.codex/config.toml`；会把 Codex hooks 标记成 degraded，并继续保留入口文档、bootstrap skill 和 MCP。
 >
-> 当前写入策略是严格防覆盖；目标文件已存在时会整体中止，不会自动合并。
+> `Codex` 的项目级 hooks 首次还需要在 `/hooks` 里完成 trust review，文件已写入不等于该 hooks 已经开始执行。
+>
+> 如果远端 skill 安装失败，CLI 会保留已成功写入的本地文件与 manifest 状态，并输出 retry 命令；但本次 `init` 会以非零退出，避免把“部分成功”误判成“初始化完成”。
 
 ## Development
 
@@ -94,13 +148,66 @@ pnpm run verify
 pnpm run verify
 ```
 
-然后按版本类型发布：
+`verify` 当前会依次执行：`typecheck -> lint -> test -> build`。
+
+正式版发布：
 
 ```bash
-pnpm run release
+pnpm run release        # 等价于 pnpm run release:patch
 pnpm run release:patch
 pnpm run release:minor
 pnpm run release:major
 ```
 
-发布脚本会依次执行 `build`、`npm publish --dry-run --access public`、`version --no-git-tag-version`、`npm publish --access public`，并发布到 npm 官方 registry。
+说明：
+
+- `release` / `release:patch`：发布下一个 patch 版本到 npm `latest`
+- `release:minor`：发布下一个 minor 版本到 npm `latest`
+- `release:major`：发布下一个 major 版本到 npm `latest`
+
+开发主线 beta 发布：
+
+```bash
+pnpm run release:beta
+# 或手动指定 buildId
+pnpm run release:beta -- 20260519143000
+# 或兼容旧方式
+BUILD_NUMBER=20260519143000 pnpm run release:beta
+```
+
+beta 流水线前置条件：
+
+- 流水线需配置私密变量 `NPM_TOKEN`
+- `NPM_TOKEN` 必须是对 `@shendu-sdt/sdt-dev-agent` 具备 publish 权限的 npm 官方 token
+- beta 发布步骤需在运行时写入 npm 官方 registry 的 `/root/.npmrc`
+- token 建议使用有限有效期并定期轮换，例如 `90 days`
+
+推荐发布分支约定：
+
+- `master`：正式版发布分支，默认手动发布，由发布人显式选择 `patch` / `minor` / `major`
+- `dev`：beta 发布分支，默认由发布人本地执行 `pnpm run release:beta`
+
+脚本强校验：
+
+- 执行 `pnpm run release:beta` 时，当前分支必须是 `dev`
+- 执行正式版发布命令时，当前分支必须是 `master`
+- 发布前工作区必须干净，不能存在本地未提交修改
+- 发布前本地分支必须与对应远端分支完全同步
+  - beta 对应 `origin/dev`
+  - 正式版对应 `origin/master`
+- 任一条件不满足时，发布脚本会直接报错并停止，不会继续写版本号或执行 `npm publish`
+
+版本规则：
+
+- 正式版由发布人明确选择 `patch` / `minor` / `major`
+- beta 会基于当前稳定版本生成“下一 patch 版本”的 `-beta.<buildId>` 版本号
+  - 不传参时，`buildId` 默认使用本地时间的 `YYYYMMDDHHmmss`
+  - 例如当前版本是 `0.1.2`，本地执行后可能发布为 `0.1.3-beta.20260519143000`
+
+发布行为：
+
+- 正式版发布到 npm `latest`
+- beta 发布到 npm `beta`
+- 发布脚本会先执行 `verify`（包含 `typecheck`、`lint`、`test`、`build`），再写入目标版本，然后对目标版本执行 `npm publish --dry-run`，最后发布到 npm 官方 registry
+- 本地 beta 发布会更新工作区中的版本号文件；发布完成后如果不打算保留该 prerelease 版本号，需要由发布人自行处理工作区状态
+- 执行 beta 发布前，发布机仍然需要具备 npm 官方 registry 的发布权限

package/dist/catalog/index.d.ts

@@ -0,0 +1,4 @@
+export { DEFAULT_SKILL_IDS, getSkillCatalogEntry, OPTIONAL_SKILL_IDS, REQUIRED_SKILL_ID, SKILL_CATALOG, SKILL_IDS, } from './skills.js';
+export { DEFAULT_MCP_IDS, getMcpCatalogEntry, MCP_CATALOG, MCP_IDS, OPTIONAL_MCP_IDS, } from './mcp.js';
+export { getWorkflowCatalogEntry, WORKFLOW_CATALOG, WORKFLOW_IDS } from './workflows.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,OAAO,EACP,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/catalog/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_SKILL_IDS, getSkillCatalogEntry, OPTIONAL_SKILL_IDS, REQUIRED_SKILL_ID, SKILL_CATALOG, SKILL_IDS, } from './skills.js';
+export { DEFAULT_MCP_IDS, getMcpCatalogEntry, MCP_CATALOG, MCP_IDS, OPTIONAL_MCP_IDS, } from './mcp.js';
+export { getWorkflowCatalogEntry, WORKFLOW_CATALOG, WORKFLOW_IDS } from './workflows.js';
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,OAAO,EACP,gBAAgB,GACjB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/catalog/mcp.d.ts

@@ -0,0 +1,12 @@
+import type { CatalogMcp, McpId } from '../types.js';
+/** MCP 能力清单，模板目录是运行时生成项目级配置的事实源。 */
+export declare const MCP_CATALOG: CatalogMcp[];
+/** 推荐模式下默认安装的 MCP ID 集合。 */
+export declare const DEFAULT_MCP_IDS: McpId[];
+/** 可选但非默认安装的 MCP ID 集合。 */
+export declare const OPTIONAL_MCP_IDS: McpId[];
+/** 对外暴露给 `list/add` 的 MCP ID 集合。 */
+export declare const MCP_IDS: McpId[];
+/** 按稳定 ID 读取单个 MCP catalog 项。 */
+export declare function getMcpCatalogEntry(mcpId: McpId): CatalogMcp;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/catalog/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/catalog/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAGpD,oCAAoC;AACpC,eAAO,MAAM,WAAW,EAAE,UAAU,EAmBH,CAAA;AAEjC,4BAA4B;AAC5B,eAAO,MAAM,eAAe,EAAE,KAAK,EAEb,CAAA;AAEtB,2BAA2B;AAC3B,eAAO,MAAM,gBAAgB,EAAE,KAAK,EAEd,CAAA;AAEtB,oCAAoC;AACpC,eAAO,MAAM,OAAO,EAAE,KAAK,EAAqC,CAAA;AAEhE,iCAAiC;AACjC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAM3D"}

package/dist/catalog/mcp.js

@@ -0,0 +1,37 @@
+import { ALL_TOOLS } from './shared.js';
+/** MCP 能力清单，模板目录是运行时生成项目级配置的事实源。 */
+export const MCP_CATALOG = [
+    {
+        id: 'context7',
+        displayName: 'Context7',
+        description: '默认安装的项目级文档检索 MCP。',
+        sourceType: 'project-template',
+        selection: 'default',
+        supportedTools: ALL_TOOLS,
+        templateBaseDir: 'mcp/context7',
+    },
+    {
+        id: 'mastergo',
+        displayName: 'MasterGo',
+        description: '选装设计稿 MCP。',
+        sourceType: 'project-template',
+        selection: 'optional',
+        supportedTools: ALL_TOOLS,
+        templateBaseDir: 'mcp/mastergo',
+    },
+];
+/** 推荐模式下默认安装的 MCP ID 集合。 */
+export const DEFAULT_MCP_IDS = MCP_CATALOG.filter((mcp) => mcp.selection === 'default').map((mcp) => mcp.id);
+/** 可选但非默认安装的 MCP ID 集合。 */
+export const OPTIONAL_MCP_IDS = MCP_CATALOG.filter((mcp) => mcp.selection === 'optional').map((mcp) => mcp.id);
+/** 对外暴露给 `list/add` 的 MCP ID 集合。 */
+export const MCP_IDS = MCP_CATALOG.map((mcp) => mcp.id);
+/** 按稳定 ID 读取单个 MCP catalog 项。 */
+export function getMcpCatalogEntry(mcpId) {
+    const mcp = MCP_CATALOG.find((item) => item.id === mcpId);
+    if (!mcp) {
+        throw new Error(`Unknown MCP catalog id: ${mcpId}`);
+    }
+    return mcp;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/catalog/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/catalog/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,SAAS;QACzB,eAAe,EAAE,cAAc;KAChC;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,SAAS;QACzB,eAAe,EAAE,cAAc;KAChC;CAC8B,CAAA;AAEjC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAY,WAAW,CAAC,MAAM,CACxD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CACrC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAEtB,2BAA2B;AAC3B,MAAM,CAAC,MAAM,gBAAgB,GAAY,WAAW,CAAC,MAAM,CACzD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,UAAU,CACtC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAEtB,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAY,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAEhE,iCAAiC;AACjC,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;IACzD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/catalog/shared.d.ts

@@ -0,0 +1,5 @@
+import type { ToolId } from '../types.js';
+/** 当前仓库支持写入配置的工具清单。 */
+export declare const ALL_TOOLS: ToolId[];
+export declare const projectRoot: string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/catalog/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/catalog/shared.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,uBAAuB;AACvB,eAAO,MAAM,SAAS,EAAE,MAAM,EAA6B,CAAA;AAI3D,eAAO,MAAM,WAAW,QAAuC,CAAA"}

package/dist/catalog/shared.js

@@ -0,0 +1,8 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** 当前仓库支持写入配置的工具清单。 */
+export const ALL_TOOLS = ['codex', 'claude-code'];
+/** 用于从 `src/catalog/*` 稳定回到仓库根目录。 */
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+export const projectRoot = path.resolve(currentDir, '..', '..');
+//# sourceMappingURL=shared.js.map

package/dist/catalog/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/catalog/shared.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAIxC,uBAAuB;AACvB,MAAM,CAAC,MAAM,SAAS,GAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;AAE3D,qCAAqC;AACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA"}

package/dist/catalog/skills.d.ts

@@ -0,0 +1,14 @@
+import type { CatalogSkill, SkillId } from '../types.js';
+/** 技能能力清单，包含一个必装本地 skill 和若干远端推荐 skill。 */
+export declare const SKILL_CATALOG: CatalogSkill[];
+/** 初始化阶段始终会安装的 bootstrap skill。 */
+export declare const REQUIRED_SKILL_ID: SkillId;
+/** 推荐模式下默认安装的远端 skill ID 集合。 */
+export declare const DEFAULT_SKILL_IDS: SkillId[];
+/** 可选但非默认安装的远端 skill ID 集合。 */
+export declare const OPTIONAL_SKILL_IDS: SkillId[];
+/** 对外暴露给 `list/add` 的 skill ID 集合，不包含必装 bootstrap skill。 */
+export declare const SKILL_IDS: SkillId[];
+/** 按稳定 ID 读取单个 skill catalog 项。 */
+export declare function getSkillCatalogEntry(skillId: SkillId): CatalogSkill;
+//# sourceMappingURL=skills.d.ts.map

package/dist/catalog/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/catalog/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAU,MAAM,aAAa,CAAA;AA0ChE,2CAA2C;AAC3C,eAAO,MAAM,aAAa,EAAE,YAAY,EAYL,CAAA;AAEnC,mCAAmC;AACnC,eAAO,MAAM,iBAAiB,EAAE,OAAkC,CAAA;AAElE,gCAAgC;AAChC,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAEb,CAAA;AAE1B,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,EAAE,OAAO,EAEd,CAAA;AAE1B,4DAA4D;AAC5D,eAAO,MAAM,SAAS,EAAE,OAAO,EAEL,CAAA;AAE1B,mCAAmC;AACnC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAMnE"}

package/dist/catalog/skills.js

@@ -0,0 +1,55 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { parseJsonText } from '../utils/json.js';
+import { ALL_TOOLS, projectRoot } from './shared.js';
+/** 从 `templates/skills/remote/catalog.json` 加载远端推荐 skill 清单。 */
+function loadRemoteSkillCatalog() {
+    const catalogPath = path.join(projectRoot, 'templates', 'skills', 'remote', 'catalog.json');
+    const raw = readFileSync(catalogPath, 'utf8');
+    const entries = parseJsonText(raw, catalogPath);
+    return entries.map((entry) => ({
+        id: entry.id,
+        displayName: entry.displayName,
+        description: entry.description,
+        sourceType: 'remote-recommended',
+        selection: entry.selection,
+        detectionMode: entry.detectionMode,
+        supportedTools: entry.supportedTools,
+        remote: {
+            source: entry.source,
+            installCommand: entry.installCommand,
+            installTargets: entry.installTargets,
+        },
+    }));
+}
+/** 技能能力清单，包含一个必装本地 skill 和若干远端推荐 skill。 */
+export const SKILL_CATALOG = [
+    {
+        id: 'bootstrap-project-docs',
+        displayName: 'bootstrap-project-docs',
+        description: '初始化项目事实文档与工具规则文档的必装 bootstrap skill。',
+        sourceType: 'builtin-local',
+        selection: 'required',
+        detectionMode: 'single',
+        supportedTools: ALL_TOOLS,
+        templateDir: 'skills/builtin/bootstrap-project-docs',
+    },
+    ...loadRemoteSkillCatalog(),
+];
+/** 初始化阶段始终会安装的 bootstrap skill。 */
+export const REQUIRED_SKILL_ID = 'bootstrap-project-docs';
+/** 推荐模式下默认安装的远端 skill ID 集合。 */
+export const DEFAULT_SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.selection === 'default').map((skill) => skill.id);
+/** 可选但非默认安装的远端 skill ID 集合。 */
+export const OPTIONAL_SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.selection === 'optional').map((skill) => skill.id);
+/** 对外暴露给 `list/add` 的 skill ID 集合，不包含必装 bootstrap skill。 */
+export const SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.id !== REQUIRED_SKILL_ID).map((skill) => skill.id);
+/** 按稳定 ID 读取单个 skill catalog 项。 */
+export function getSkillCatalogEntry(skillId) {
+    const skill = SKILL_CATALOG.find((item) => item.id === skillId);
+    if (!skill) {
+        throw new Error(`Unknown skill catalog id: ${skillId}`);
+    }
+    return skill;
+}
+//# sourceMappingURL=skills.js.map

package/dist/catalog/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/catalog/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,IAAI,MAAM,WAAW,CAAA;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAkBpD,gEAAgE;AAChE,SAAS,sBAAsB;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;IAC3F,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,aAAa,CAA6B,GAAG,EAAE,WAAW,CAAC,CAAA;IAE3E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,oBAAoB;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,MAAM,EAAE;YACN,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC;KACF,CAAC,CAAC,CAAA;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,sCAAsC;QACnD,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,UAAU;QACrB,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,SAAS;QACzB,WAAW,EAAE,uCAAuC;KACrD;IACD,GAAG,sBAAsB,EAAE;CACM,CAAA;AAEnC,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAY,wBAAwB,CAAA;AAElE,gCAAgC;AAChC,MAAM,CAAC,MAAM,iBAAiB,GAAc,aAAa,CAAC,MAAM,CAC9D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CACzC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAE1B,+BAA+B;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAc,aAAa,CAAC,MAAM,CAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,CAC1C,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAE1B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAc,aAAa,CAAC,MAAM,CACtD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,iBAAiB,CAC1C,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAE1B,mCAAmC;AACnC,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAA;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/catalog/workflows.d.ts

@@ -0,0 +1,8 @@
+import type { CatalogWorkflow, WorkflowId } from '../types.js';
+/** workflow 能力清单，当前只维护独立于 skill 的 OpenSpec 集成。 */
+export declare const WORKFLOW_CATALOG: CatalogWorkflow[];
+/** 对外暴露给 `list/add` 的 workflow ID 集合。 */
+export declare const WORKFLOW_IDS: WorkflowId[];
+/** 按稳定 ID 读取单个 workflow catalog 项。 */
+export declare function getWorkflowCatalogEntry(workflowId: WorkflowId): CatalogWorkflow;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/catalog/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/catalog/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG9D,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAUR,CAAA;AAEtC,yCAAyC;AACzC,eAAO,MAAM,YAAY,EAAE,UAAU,EAAoD,CAAA;AAEzF,sCAAsC;AACtC,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAM/E"}

package/dist/catalog/workflows.js

@@ -0,0 +1,24 @@
+import { ALL_TOOLS } from './shared.js';
+/** workflow 能力清单，当前只维护独立于 skill 的 OpenSpec 集成。 */
+export const WORKFLOW_CATALOG = [
+    {
+        id: 'openspec',
+        displayName: 'OpenSpec',
+        description: '独立的 spec-driven workflow 工作流能力，不属于普通 skills 或 MCP。',
+        sourceType: 'workflow-integration',
+        supportedTools: ALL_TOOLS,
+        templateBaseDir: 'workflows/openspec',
+        installCommand: 'npx -y @fission-ai/openspec@latest init --tools <tool> --profile core .',
+    },
+];
+/** 对外暴露给 `list/add` 的 workflow ID 集合。 */
+export const WORKFLOW_IDS = WORKFLOW_CATALOG.map((workflow) => workflow.id);
+/** 按稳定 ID 读取单个 workflow catalog 项。 */
+export function getWorkflowCatalogEntry(workflowId) {
+    const workflow = WORKFLOW_CATALOG.find((item) => item.id === workflowId);
+    if (!workflow) {
+        throw new Error(`Unknown workflow catalog id: ${workflowId}`);
+    }
+    return workflow;
+}
+//# sourceMappingURL=workflows.js.map

package/dist/catalog/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/catalog/workflows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE,sBAAsB;QAClC,cAAc,EAAE,SAAS;QACzB,eAAe,EAAE,oBAAoB;QACrC,cAAc,EAAE,yEAAyE;KAC1F;CACmC,CAAA;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAiB,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AAEzF,sCAAsC;AACtC,MAAM,UAAU,uBAAuB,CAAC,UAAsB;IAC5D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAA;IACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/cli/index.js

@@ -1,5 +1,8 @@
 import { Command } from 'commander';
+import { runAddMcpCommand, runAddSkillCommand, runAddWorkflowCommand } from '../commands/add.js';
 import { runInitCommand } from '../commands/init.js';
+import { runListMcpCommand, runListSkillsCommand, runListWorkflowsCommand, } from '../commands/list.js';
+import { runStatusCommand } from '../commands/status.js';
 const program = new Command();
 program
     .name('sdt-dev-agent')
@@ -7,10 +10,11 @@ program
     .version('0.1.0');
 program
     .command('init [targetPath]')
-    .description('Initialize SDT DevAgent assets in an existing project')
+    .description('Initialize bootstrap skills, tool integrations, and MCP config in a project')
     .option('--tools <tools>', 'Comma-separated tools: codex,claude-code')
-    .option('--install-mode <mode>', 'Install mode: recommended|minimal|custom')
-    .option('--capabilities <capabilities>', 'Comma-separated capabilities: base-assets,skills,mcp')
+    .option('--install-mode <mode>', 'Install mode: recommended|custom')
+    .option('--skills <skills>', 'Comma-separated remote skill ids for custom install')
+    .option('--mcp <mcp>', 'Comma-separated MCP ids for custom install')
     .option('--yes', 'Use default selections without prompting')
     .action(async (targetPath = '.', options) => {
     try {
@@ -22,5 +26,70 @@ program
         process.exitCode = 1;
     }
 });
+program
+    .command('status [targetPath]')
+    .description('Show current project capability status')
+    .action(async (targetPath = '.') => {
+    try {
+        await runStatusCommand(targetPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(message);
+        process.exitCode = 1;
+    }
+});
+const listCommand = program.command('list').description('Show installable capability catalogs');
+listCommand.command('skills').description('List installable skills').action(runListSkillsCommand);
+listCommand.command('mcp').description('List installable MCP servers').action(runListMcpCommand);
+listCommand
+    .command('workflows')
+    .description('List installable workflows')
+    .action(runListWorkflowsCommand);
+const addCommand = program
+    .command('add')
+    .description('Add a skill, MCP, or workflow to an initialized project');
+addCommand
+    .command('skill <name>')
+    .description('Add a skill to the initialized project')
+    .option('--tool <tool>', 'Limit installation to one initialized tool')
+    .action(async (name, options) => {
+    try {
+        await runAddSkillCommand(name, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(message);
+        process.exitCode = 1;
+    }
+});
+addCommand
+    .command('mcp <name>')
+    .description('Add an MCP server to the initialized project')
+    .option('--tool <tool>', 'Limit installation to one initialized tool')
+    .action(async (name, options) => {
+    try {
+        await runAddMcpCommand(name, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(message);
+        process.exitCode = 1;
+    }
+});
+addCommand
+    .command('workflow <name>')
+    .description('Add a workflow to the initialized project')
+    .option('--tool <tool>', 'Limit installation to one initialized tool')
+    .action(async (name, options) => {
+    try {
+        await runAddWorkflowCommand(name, options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(message);
+        process.exitCode = 1;
+    }
+});
 await program.parseAsync(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;KACrE,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,CAAC;KAC3E,MAAM,CAAC,+BAA+B,EAAE,sDAAsD,CAAC;KAC/F,MAAM,CAAC,OAAO,EAAE,0CAA0C,CAAC;KAC3D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE;IAC1C,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;QACxE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACtB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/add.d.ts

@@ -0,0 +1,7 @@
+export interface AddCommandOptions {
+    tool?: string;
+}
+export declare function runAddSkillCommand(skillId: string, options?: AddCommandOptions): Promise<void>;
+export declare function runAddWorkflowCommand(workflowId: string, options?: AddCommandOptions): Promise<void>;
+export declare function runAddMcpCommand(mcpId: string, options?: AddCommandOptions): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA6FD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Ff;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAkFf;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Ef"}