@shendu-sdt/sdt-dev-agent 0.1.3-beta.9 → 0.1.3

package/templates/skills/builtin/bootstrap-project-docs/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Bootstrap Project Docs"
+  short_description: "Generate project docs from real code"
+  default_prompt: "Use $bootstrap-project-docs to create or refresh ARCHITECTURE.md first, then replace the minimal AGENTS.md or CLAUDE.md bootstrap entry with project-specific rules from the current repository."

package/templates/skills/builtin/bootstrap-project-docs/references/architecture-first.md

@@ -1,7 +1,19 @@
 # Architecture First
 
-项目事实文档 `ARCHITECTURE.md` 是后续规则文档的事实源。
+Make `ARCHITECTURE.md` the repository fact source.
 
-- 只写源码、配置、目录结构中能确认的事实
-- 无法确认的信息标记为“待确认”
-- 过时或错误描述直接删除，不保留历史口径
+## Write for future implementation
+
+- Capture the real layering, key directories, build and test entry points, and the normal place for new code.
+- Delete stale or incorrect statements instead of preserving historical wording.
+
+## Use only confirmed facts
+
+- Derive facts from source code, configuration, package scripts, and directory structure.
+- Treat other docs and existing rule files only as hints to verify.
+- Mark unresolved but important items as `待确认`.
+
+## Refresh instead of stacking
+
+- If `ARCHITECTURE.md` already exists but no longer matches the repo, rewrite the stale sections from current code.
+- Do not append a new layer of prose onto an outdated architecture doc.

package/templates/skills/builtin/bootstrap-project-docs/references/doc-state-routing.md

@@ -0,0 +1,28 @@
+# Document State Routing
+
+Route the work from the current root-document state.
+
+## Neither document exists
+
+- Create `ARCHITECTURE.md` first.
+- Create `{{toolRulesDoc}}` immediately after `ARCHITECTURE.md`.
+- Do not stop at a reminder or a to-do list.
+
+## `ARCHITECTURE.md` and `{{toolRulesDoc}}` both exist
+
+- Read the code first, then read both documents.
+- If both still match the repository, keep edits minimal or skip doc changes.
+- If either document is stale, refresh `ARCHITECTURE.md` first and then sync `{{toolRulesDoc}}`.
+
+## Only `{{toolRulesDoc}}` exists
+
+- Treat `{{toolRulesDoc}}` as a candidate rule set, not as a fact source.
+- If it is only the minimal bootstrap entry, replace it after the architecture pass.
+- Build `ARCHITECTURE.md` from code and config.
+- Revisit `{{toolRulesDoc}}` after that, keeping only rules that still match the new architecture baseline.
+
+## Only `ARCHITECTURE.md` exists
+
+- Verify whether `ARCHITECTURE.md` still matches the repository.
+- If it does, create `{{toolRulesDoc}}` from it.
+- If it does not, refresh `ARCHITECTURE.md` first and then create `{{toolRulesDoc}}`.

package/templates/skills/builtin/bootstrap-project-docs/references/tool-rules-follow-up.md

@@ -1,8 +1,23 @@
 # Tool Rules Follow-up
 
-在 `ARCHITECTURE.md` 完成后：
+Create or refresh `{{toolRulesDoc}}` only after `ARCHITECTURE.md` is trustworthy.
 
-- `Codex` 项目再生成或刷新 `AGENTS.md`
-- `Claude Code` 项目再生成或刷新 `CLAUDE.md`
+## Scope
 
-工具级规则文档只负责执行规则，不重复写项目事实。
+- Write execution rules for the current tool, not project facts.
+- Keep the doc short, specific, and actionable.
+- Avoid changing business code while doing this doc pass.
+
+## Minimum contents
+
+- Read `ARCHITECTURE.md` before making broader edits.
+- Follow the repository's existing directories and coding patterns.
+- Avoid unrelated refactors, formatting churn, scope creep, and surprise dependencies.
+- Include the common local develop, build, test, or verification commands when they are easy to confirm.
+- Refuse to guess when architecture or source code does not confirm something.
+
+## Existing-rule cleanup
+
+- If `{{toolRulesDoc}}` is only the minimal bootstrap entry, treat it as a target to replace rather than a source to preserve.
+- If `{{toolRulesDoc}}` already exists, keep only the rules that still match the repository.
+- If the project previously had only `{{toolRulesDoc}}`, remove or rewrite rules that were based on stale assumptions after `ARCHITECTURE.md` is rebuilt.

package/dist/catalog.d.ts

@@ -1,16 +0,0 @@
-import type { CatalogMcp, CatalogSkill, CatalogWorkflow, McpId, SkillId, WorkflowId } from './types.js';
-export declare const SKILL_CATALOG: CatalogSkill[];
-export declare const MCP_CATALOG: CatalogMcp[];
-export declare const WORKFLOW_CATALOG: CatalogWorkflow[];
-export declare const REQUIRED_SKILL_ID: SkillId;
-export declare const DEFAULT_SKILL_IDS: SkillId[];
-export declare const OPTIONAL_SKILL_IDS: SkillId[];
-export declare const DEFAULT_MCP_IDS: McpId[];
-export declare const OPTIONAL_MCP_IDS: McpId[];
-export declare const SKILL_IDS: SkillId[];
-export declare const MCP_IDS: McpId[];
-export declare const WORKFLOW_IDS: WorkflowId[];
-export declare function getSkillCatalogEntry(skillId: SkillId): CatalogSkill;
-export declare function getMcpCatalogEntry(mcpId: McpId): CatalogMcp;
-export declare function getWorkflowCatalogEntry(workflowId: WorkflowId): CatalogWorkflow;
-//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,KAAK,EACL,OAAO,EACP,UAAU,EAEX,MAAM,YAAY,CAAA;AA4CnB,eAAO,MAAM,aAAa,EAAE,YAAY,EAYL,CAAA;AAEnC,eAAO,MAAM,WAAW,EAAE,UAAU,EAmBH,CAAA;AAEjC,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAUR,CAAA;AAEtC,eAAO,MAAM,iBAAiB,EAAE,OAAkC,CAAA;AAClE,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAEb,CAAA;AAC1B,eAAO,MAAM,kBAAkB,EAAE,OAAO,EAEd,CAAA;AAC1B,eAAO,MAAM,eAAe,EAAE,KAAK,EAEb,CAAA;AACtB,eAAO,MAAM,gBAAgB,EAAE,KAAK,EAEd,CAAA;AAEtB,eAAO,MAAM,SAAS,EAAE,OAAO,EAEL,CAAA;AAC1B,eAAO,MAAM,OAAO,EAAE,KAAK,EAAqC,CAAA;AAChE,eAAO,MAAM,YAAY,EAAE,UAAU,EAAoD,CAAA;AAEzF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAMnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAM3D;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAM/E"}

package/dist/catalog.js

@@ -1,98 +0,0 @@
-import { readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const ALL_TOOLS = ['codex', 'claude-code'];
-const currentDir = path.dirname(fileURLToPath(import.meta.url));
-const projectRoot = path.resolve(currentDir, '..');
-function loadRemoteSkillCatalog() {
-    const raw = readFileSync(path.join(projectRoot, 'templates', 'skills', 'remote', 'catalog.json'), 'utf8');
-    const entries = JSON.parse(raw);
-    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,
-        },
-    }));
-}
-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(),
-];
-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',
-    },
-];
-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 .',
-    },
-];
-export const REQUIRED_SKILL_ID = 'bootstrap-project-docs';
-export const DEFAULT_SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.selection === 'default').map((skill) => skill.id);
-export const OPTIONAL_SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.selection === 'optional').map((skill) => skill.id);
-export const DEFAULT_MCP_IDS = MCP_CATALOG.filter((mcp) => mcp.selection === 'default').map((mcp) => mcp.id);
-export const OPTIONAL_MCP_IDS = MCP_CATALOG.filter((mcp) => mcp.selection === 'optional').map((mcp) => mcp.id);
-export const SKILL_IDS = SKILL_CATALOG.filter((skill) => skill.id !== REQUIRED_SKILL_ID).map((skill) => skill.id);
-export const MCP_IDS = MCP_CATALOG.map((mcp) => mcp.id);
-export const WORKFLOW_IDS = WORKFLOW_CATALOG.map((workflow) => workflow.id);
-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;
-}
-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;
-}
-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=catalog.js.map

package/dist/catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}