@jingyi0605/codingns 0.3.6 → 0.5.0

package/dist/server/modules/skills/builtin-skills/codingns-assistant/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: codingns-assistant
-description: Use when working inside CodingNS and needing to inspect托管项目、真实会话、受控终端，或通过 `codingns assistant ...` 代理推进任务。 This skill enforces the boundary “不直接写项目代码，只通过会话或终端代理执行”, and tells Codex to prepare auth first in Butler workspaces, then discover capabilities, query CLI help on demand, and run the minimum necessary CLI command.
+description: Use when working inside CodingNS and needing to inspect托管项目、真实会话、受控终端，或通过 `codingns assistant ...` 代理推进任务。 This skill enforces the boundary “不直接修改工作区代码；涉及工作区时只通过会话或终端代理执行；纯助手沙箱任务可直接落文件”, and tells Codex to prepare auth first in Butler workspaces, then discover capabilities, query CLI help on demand, and run the minimum necessary CLI command.
 ---
 
 # CodingNS Assistant
@@ -9,36 +9,39 @@ description: Use when working inside CodingNS and needing to inspect托管项目
 
 用这套 Skill 时，永远把 `codingns assistant ...` 当成唯一正式入口。
 
-不要直接写项目代码，不要自己编造接口，不要把整份命令手册长期塞进上下文。
+不要直接修改工作区代码，不要自己编造接口，不要把整份命令手册长期塞进上下文。
 
 ## 固定边界
 
-- 禁止直接修改项目文件。
-- 只能通过真实项目会话或受控终端代理执行。
+- 禁止直接修改任何正式工作区或项目仓库文件。
+- 如果任务只发生在当前助手沙箱，可以直接写文件或写临时代码。
+- 只要涉及正式工作区，就只能通过真实项目会话或受控终端代理执行。
 - 优先查事实，再决定要不要发送消息、发终端输入或 fork。
 - 不清楚命令参数时，先跑 help，再执行真正命令。
 
 ## 默认工作流
 
-1. 如果当前目录或任务里出现 `BUTLER_CONTEXT.md`、`BUTLER_API.md`、Butler 工作区，先读 `BUTLER_API.md`。
-2. 在 Butler 工作区里，优先直接执行 `codingns assistant ...`；CLI 会按固定顺序自动读取 `--token`、环境变量、`CODINGNS_AUTH_FILE` / `BUTLER_AUTH_FILE`、当前目录及上级目录里的 `BUTLER_AUTH.json`。
+1. 如果当前目录或任务里出现 `BUTLER_CONTEXT.md`、`BUTLER_API.md`、助手沙箱工作区，先读 `BUTLER_API.md`。
+2. 在当前助手沙箱工作区里，优先直接执行 `codingns assistant ...`；CLI 会按固定顺序自动读取 `--token`、环境变量、`CODINGNS_AUTH_FILE` / `BUTLER_AUTH_FILE`、当前目录及上级目录里的 `BUTLER_AUTH.json`。
 3. 只有这些固定认证入口都不可用时，才回头核对 `BUTLER_API.md` 里的凭证文件路径，或向用户要 token。
 4. 认证入口可用后，再跑 `codingns assistant capabilities list`，确认当前环境开放了哪些能力。
 5. 要看工作区或工作树时，先跑 `codingns assistant workspaces --help`、`codingns assistant worktrees --help`。
 6. 要分析调试目标、显式请求端口或启动调试进程时，先跑 `codingns assistant debug-targets --help`。
 7. 要查单次调试运行态时，先跑 `codingns assistant debug-runtimes --help`。
 8. 要找项目时，先跑 `codingns assistant projects --help`，再决定用 `list` 还是 `get`。
-9. 要找会话时，先跑 `codingns assistant sessions --help`，再决定用 `list / get / messages / runtime`。
-10. 要推进开发时，优先用 `codingns assistant sessions send`。
-11. 只有明确需要终端链路时，才用 `codingns assistant terminals send` 或 `codingns assistant terminals close`。
-12. 要从现有上下文开新分支时，才用 `codingns assistant sessions fork`。
+9. 要找会话时，先跑 `codingns assistant sessions --help`，再决定用 `list / start / get / messages / runtime / send / fork`。
+10. 如果用户没指定工作区，但你只是需要落临时文件、写分析脚本、做独立样例，直接在当前助手沙箱里处理，不要额外新建一层会话。
+11. 要推进正式工作区开发时，如果明确是在续写已有真实会话，才用 `codingns assistant sessions send`；如果没有明确续写目标，优先用 `codingns assistant sessions start` 按当前助手配置新建真实会话。
+12. 如果要等待真实会话回复，或者未来某个具体时间后再继续，必须用 `codingns assistant timers create` 创建计时器，不能只在回答里说“稍后继续”。
+13. 只有明确需要终端链路时，才用 `codingns assistant terminals send` 或 `codingns assistant terminals close`。
+14. 要从现有上下文开新分支时，才用 `codingns assistant sessions fork`。
 
 ## Butler 认证补充
 
-- 在 Butler 工作区里，不要先故意跑一条会失败的 `codingns assistant ...` 再回头找 token。
+- 在当前助手沙箱工作区里，不要先故意跑一条会失败的 `codingns assistant ...` 再回头找 token。
 - 优先顺序固定为：显式 `--token` / `CODINGNS_ACCESS_TOKEN` / `CODINGNS_AUTH_FILE` / 当前目录及上级目录里的 `BUTLER_AUTH.json`。
 - CLI 已能自动发现 `BUTLER_AUTH.json` 时，直接继续用 `codingns assistant ...`；不要再把手工导出环境变量当成默认流程。
-- 只有自动发现失败、当前目录不在 Butler 工作区，或者你要切换到别的 Host / 凭证文件时，才手工导出环境变量。
+- 只有自动发现失败、当前目录不在当前助手沙箱工作区，或者你要切换到别的 Host / 凭证文件时，才手工导出环境变量。
 - 如果 `BUTLER_API.md` 已经写死凭证文件路径，就把它当成兜底事实来源，不要自己猜别的认证入口。
 
 ## 什么时候读 references
@@ -67,6 +70,10 @@ description: Use when working inside CodingNS and needing to inspect托管项目
   先 `codingns assistant debug-targets launch-plan --help`，确认 `--port-request` 语法后再执行。
 - “给这个会话继续发任务”：
   先 `codingns assistant sessions send --help`，确认参数后再发送。
+- “没有明确续写目标，要把任务发到真实项目里”：
+  先 `codingns assistant sessions start --help`，确认参数后再新建会话。
+- “等 5 分钟后再回来检查真实会话”：
+  先 `codingns assistant timers create --help`，再创建计时器。
 - “终端里补一个测试命令”：
   先 `codingns assistant terminals history <terminalId>` 看最近输出，再决定是否 `send`。
 

package/dist/server/modules/skills/builtin-skills/codingns-assistant/references/cli-workflow.md

@@ -3,7 +3,9 @@
 ## 1. 总原则
 
 - 先确认认证入口可用，再查能力，再查对象，再执行动作。
-- 不直接写项目代码。
+- 不直接修改正式工作区代码。
+- 如果任务只发生在当前助手沙箱，可以直接写文件、写脚本、生成临时产物。
+- 只要涉及正式工作区，就通过真实项目会话或受控终端推进执行。
 - 不知道参数时先查 help，不要硬猜。
 
 ## 2. 先确认认证入口
@@ -11,8 +13,8 @@
 - 显式传了 `--token` / `--base-url` 就直接用。
 - 如果已设置 `CODINGNS_ACCESS_TOKEN` / `CODINGNS_BASE_URL`，直接继续执行。
 - 如果设置了 `CODINGNS_AUTH_FILE` 或 `BUTLER_AUTH_FILE`，CLI 会从那个文件读取。
-- 在 Butler 工作区里，CLI 默认会继续向上查找 `BUTLER_AUTH.json`，通常不需要手工 export 环境变量。
-- 只有自动发现失败、当前目录不在 Butler 工作区，或者要切换到别的 Host / 凭证文件时，才手工导出环境变量或显式传 `--token`。
+- 在当前助手沙箱工作区里，CLI 默认会继续向上查找 `BUTLER_AUTH.json`，通常不需要手工 export 环境变量。
+- 只有自动发现失败、当前目录不在当前助手沙箱工作区，或者要切换到别的 Host / 凭证文件时，才手工导出环境变量或显式传 `--token`。
 
 ## 3. 先查哪些 help
 
@@ -90,7 +92,9 @@ codingns assistant sessions messages <sessionId> --limit 20 [--token <token>]
 ### 通过真实会话推进开发
 
 ```bash
+codingns assistant sessions start --project <projectId> --message "继续处理这个任务" [--token <token>]
 codingns assistant sessions send <sessionId> --message "继续修复类型错误" [--token <token>]
+codingns assistant timers create --after-seconds 300 --message "5 分钟后检查真实会话回复" --session-id <sessionId> --project-id <projectId> [--token <token>]
 ```
 
 如果需要从某条消息重新开分支：
@@ -122,7 +126,9 @@ codingns assistant terminals close <terminalId> --token <token>
 - 需要看子工作树能不能合并：优先 `worktrees merge-preview`
 - 需要为并行工作区分析调试目标或固定端口：优先 `debug-targets analyze`、`debug-targets launch-plan`
 - 需要看显式端口请求有没有落到实际运行时：优先 `debug-targets runtime-latest`、`debug-runtimes get`
+- 没有明确续写目标、要把任务发进真实项目：优先 `sessions start`
 - 需要继续已有开发上下文：优先 `sessions send`
+- 需要等待真实会话回复或未来某个时间继续：优先 `timers create`
 - 需要查看会话是否还活着：优先 `sessions runtime`
 - 需要看模型最近说了什么：优先 `sessions messages`
 - 需要看构建、测试、脚本输出：优先 `terminals history`

package/dist/server/modules/skills/skill-controller.d.ts

@@ -1,5 +1,5 @@
 import type { FastifyReply, FastifyRequest } from "fastify";
-import type { AddManagedSkillInput, ImportUnmanagedSkillInput, SyncManagedSkillInput } from "./skill-manager-service.js";
+import type { AddManagedSkillInput, AddManagedSkillFromMarkdownInput, ImportUnmanagedSkillInput, SyncManagedSkillInput } from "./skill-manager-service.js";
 import { SkillManagerService } from "./skill-manager-service.js";
 interface SkillOverviewQuery {
     targetCli?: string | string[];
@@ -11,7 +11,7 @@ export declare class SkillController {
         Querystring: SkillOverviewQuery;
     }>, reply: FastifyReply) => Promise<void>;
     readonly add: (request: FastifyRequest<{
-        Body: AddManagedSkillInput;
+        Body: AddManagedSkillInput | AddManagedSkillFromMarkdownInput;
     }>, reply: FastifyReply) => Promise<void>;
     readonly import: (request: FastifyRequest<{
         Body: ImportUnmanagedSkillInput;

package/dist/server/modules/skills/skill-controller.js

@@ -10,7 +10,12 @@ export class SkillController {
     };
     add = async (request, reply) => {
         requireUserId(request);
-        reply.send(this.skillManagerService.addManagedSkill(request.body ?? { sourcePath: "", targetCli: [], sourceType: "local-import" }));
+        const body = request.body;
+        if (isMarkdownSkillInput(body)) {
+            reply.send(this.skillManagerService.addManagedSkillFromMarkdown(body));
+            return;
+        }
+        reply.send(this.skillManagerService.addManagedSkill(body ?? { sourcePath: "", targetCli: [], sourceType: "local-import" }));
     };
     import = async (request, reply) => {
         requireUserId(request);
@@ -21,6 +26,9 @@ export class SkillController {
         reply.send(this.skillManagerService.syncManagedSkill(request.body ?? { skillId: "", targetCli: [] }));
     };
 }
+function isMarkdownSkillInput(input) {
+    return Boolean(input && "markdownContent" in input && typeof input.markdownContent === "string");
+}
 function normalizeTargetCliQuery(query) {
     if (!query?.targetCli) {
         return {};

package/dist/server/modules/skills/skill-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-controller.js","sourceRoot":"","sources":["../../../../src/modules/skills/skill-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAazD,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAEhE,WAAW,GAAG,KAAK,EAC1B,OAA4D,EAC5D,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC;IAEO,GAAG,GAAG,KAAK,EAClB,OAAuD,EACvD,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IACtI,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAA4D,EAC5D,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACvH,CAAC,CAAC;IAEO,IAAI,GAAG,KAAK,EACnB,OAAwD,EACxD,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;CACH;AAED,SAAS,uBAAuB,CAAC,KAAqC;IACpE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC,KAAK,CAAC,SAAS;QACjB,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,SAAS,EAAE,SAA2C;KACvD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"skill-controller.js","sourceRoot":"","sources":["../../../../src/modules/skills/skill-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAczD,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAEhE,WAAW,GAAG,KAAK,EAC1B,OAA4D,EAC5D,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC;IAEO,GAAG,GAAG,KAAK,EAClB,OAA0F,EAC1F,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,IAAI,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAC9H,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAA4D,EAC5D,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACvH,CAAC,CAAC;IAEO,IAAI,GAAG,KAAK,EACnB,OAAwD,EACxD,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;CACH;AAED,SAAS,oBAAoB,CAC3B,KAA0E;IAE1E,OAAO,OAAO,CAAC,KAAK,IAAI,iBAAiB,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAqC;IACpE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC,KAAK,CAAC,SAAS;QACjB,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,SAAS,EAAE,SAA2C;KACvD,CAAC;AACJ,CAAC"}

package/dist/server/modules/skills/skill-manager-service.d.ts

@@ -1,4 +1,4 @@
-import type { ManagedSkillRecord, SkillSourceType, SkillScanResult, SkillTargetBindingRecord, SkillTargetCli, SkillTargetSyncStatus } from "../../types/domain.js";
+import type { ManagedSkillRecord, SkillScope, SkillSourceType, SkillScanResult, SkillTargetBindingRecord, SkillTargetCli, SkillTargetSyncStatus } from "../../types/domain.js";
 import type { ManagedSkillRepository } from "../../storage/repositories/managed-skill-repository.js";
 import type { SkillTargetBindingRepository } from "../../storage/repositories/skill-target-binding-repository.js";
 import { type SkillTargetAdapter } from "./skill-target-adapter.js";
@@ -11,6 +11,14 @@ export interface AddManagedSkillInput {
     sourcePath: string;
     targetCli: readonly SkillTargetCli[];
     sourceType: SkillSourceType;
+    scope?: SkillScope;
+}
+export interface AddManagedSkillFromMarkdownInput {
+    markdownContent: string;
+    targetCli: readonly SkillTargetCli[];
+    fileName?: string | null;
+    directoryName?: string | null;
+    scope?: SkillScope;
 }
 export interface SyncManagedSkillInput {
     skillId: string;
@@ -45,6 +53,18 @@ export interface ManagedSkillOverviewItem {
     bindings: SkillTargetBindingRecord[];
     ssotPath: string;
 }
+export interface AssistantRuntimeSkillOverviewItem {
+    name: string;
+    directoryName: string;
+    sourcePath: string;
+    usedByTargetCli: readonly SkillTargetCli[];
+}
+export interface AssistantRuntimeSkillSource {
+    name: string;
+    directoryName: string;
+    sourcePath: string;
+    usedByTargetCli: readonly SkillTargetCli[];
+}
 export interface SkillOverviewResult {
     summary: {
         managedSkillCount: number;
@@ -54,6 +74,7 @@ export interface SkillOverviewResult {
         diagnosticCount: number;
     };
     managedSkills: ManagedSkillOverviewItem[];
+    assistantRuntimeSkills: AssistantRuntimeSkillOverviewItem[];
     managedEntries: SkillScanResult["managed"];
     unmanagedEntries: SkillScanResult["unmanaged"];
     conflictedEntries: SkillScanResult["conflicted"];
@@ -76,7 +97,9 @@ export declare class SkillManagerService {
     scanSkills(options?: ScanSkillsOptions): SkillScanResult;
     getOverview(options?: ScanSkillsOptions): SkillOverviewResult;
     addManagedSkill(input: AddManagedSkillInput): ManagedSkillMutationResult;
+    addManagedSkillFromMarkdown(input: AddManagedSkillFromMarkdownInput): ManagedSkillMutationResult;
     syncManagedSkill(input: SyncManagedSkillInput): ManagedSkillMutationResult;
+    listAssistantRuntimeSkillSources(targetCli?: readonly SkillTargetCli[]): AssistantRuntimeSkillSource[];
     ensureBuiltinSkill(input: EnsureBuiltinSkillInput): ManagedSkillMutationResult;
     importUnmanagedSkill(input: ImportUnmanagedSkillInput): ManagedSkillMutationResult;
     private syncManagedSkillRecord;
@@ -87,6 +110,8 @@ export declare class SkillManagerService {
     private resolveSsotPath;
     private createManagedSkillId;
     private now;
+    private registerManagedSkillFromSource;
+    private upsertAssistantRuntimeBindings;
 }
 export declare function readSkillDirectorySnapshot(targetCli: SkillTargetCli, rootDir: string, directoryPath: string): DiscoveredSkillDirectory;
 export declare function computeSkillDirectoryHash(directoryPath: string): string;