更改光谱客户端
@alterset/alterspec-client 带来工作 换相 产品
检查建立产品的储存库。 利用它,一个在克洛德码公司工作的开发商 承担了一项任务
更改光谱调度器,仅读取任务需要的光谱部分,构建它,并报告进度和完成情况
回来 客户端从不编辑 spec.
它还带有导出格式 work.json (单位:千美元)@alterset/alterspec-client/work)为调度所.
新来的调度员? 从分步开始 开发者指南 (单位:千美元)developer-guide.md 内
此软件包: SSH 密钥, 设置一个寄存器, 签名, 从开始到完成的任务 。 这个读取器是
参考文献.
你需要的东西
- 节点.js 20或以后,git,和 克劳德代码。 。 。 .
- 调度员的URL 从您的管理员.
- 复制 导出 寄存器 : 您团队创建的已签名产品规格 。 客户拉出它. 绝不用手编辑.
- 一个
ssh-ed25519键:在 ssh-agent 中,或~/.ssh/id_ed25519签名给调度员使用。 没有 要管理的密码或令牌 .
单词
- 任务: 一个音轨上的签名更改, 写入
CHG-012/BE。 。 。 . - 音轨:一流的建筑工程. 这不是一个渠道.
BE是后端(包括每个 API 频道)。 每个 其他音轨是一款设计,由拥有该音轨的信道的代码命名(BO, (中文(简体) ),MOB) (中文(简体) ). 共享的频道 另外一个设计是在那个频道的赛道上建造的. - 核对清单:一项任务的项目,例如接受标准(
CAP-CAT-001-AC-03),屏幕动作(SCR-PRC-01.A02(中文(简体) ) 经验说明UX-SCR-PRC-01-WEB#error) (中文(简体) ). 进展算上你承诺的掩护. - 然后显示: 一个标准
Then系统保证的是什么(后端的),它的Shown什么屏幕 显示( 一个 UI 音轨的) 。 任务核对表只包含一项标准;一项没有Shown这是所有的 后卫的. - 反馈:当任务核对表被覆盖时,代理人会告诉调度员该类别中哪些内容不明确,什么 它不得不打开 超出简报 和它自己决定的, 命名ID, 所以产品方面可以固定 光谱.
- 问题:当spec不做决定时,经纪人会问
/alterspec-spec-ask。答案是: 在产品方面确认或纠正之前 它,或打开(等它), 调度员保留假设和开放假设(一个来自 spec 的答案是 未发送);一个产品人回答那里,并在光谱说出来后标记每个光谱与光谱调和.
设置仓库
在创建一个或多个音轨的寄存器根中:
npx @alterset/alterspec-client init --dispatcher https://<dispatcher> --export ../<export-clone> --track BE
| 选项 | 含义 |
|---|---|
--dispatcher <url> | 调度员的URL. |
--export <path> | 您的导出仓库的克隆, 相对于此仓库或绝对值 . |
--track <code...> | 存储器所构建的音轨( T)BE, (中文(简体) ), BO允许几个: --track BE BO。 。 。 . |
--worktrees <path> | 工作树去的地方。 默认 : ../<repo>-tasks。 。 。 . |
--key <key> | 要签名的公用钥匙,作为 .pub 路径或密钥行。 默认: 第一个 ssh-ed25519 键,然后 ~/.ssh/id_ed25519.pub。 。 。 . |
--branch <name> | 赛道主分支. 默认: 远程 HEAD,则 main。 。 。 . |
--force | 替换您修改过的技能 . |
init 写道:
.alterspec-client.json:上方配置..mcp.json页:1dispatcherMCP 服务器( U)npx @alterset/alterspec-client mcp) (中文(简体) )..claude/settings.json: 一条钩子, 报告每个钩子之后的进展git commit。 。 。 ..claude/settings.local.json: 您对dispatcher服务器( e)"enabledMcpjsonServers": ["dispatcher"], (中文(简体) ), 和档案里的其他东西合并了 Claude 代码从项目中装入服务器.mcp.json只有一次才会 批准,并尊重这一批准 只在不跟踪文件,所以init将文件添加到.gitignore还没有忽略它的时候..claude/skills/alterspec-*:技能,是薄薄的包装..alterspec-client/prompts/:技能背后的完整指示.
还能安全运行 运行它同样更新客户端: 它添加了新版本的技能, 删除
那些掉下来的, 保持任何你编辑的技能,除非你通过 --force。交出它所写的一切,除非
.claude/settings.local.json因此,任务工作树也有它. worktree 将批准写入每个新任务
工作树本身。 如果您将设置保留在 git 中, 作为顶级的同位素链接到另一个寄存器(.claude, (中文(简体) ),
.mcp.json, (中文(简体) ), .alterspec-client),被打晕了, worktree 将每个人连接到新的工作树上。 如果与相对目标存在这种联系,则
它不会从工作树上指出一个更深的文件夹, worktree 链接它在工作树上丢失的文件夹
文件夹到您退出的旁边的文件夹( x)../<repo>-tasks/ops → ../ops),所有任务都共享; git sees
无变化.
何时 .claude 是另一个寄存器的符号链接, git 无法分辨该文件是否被忽略 : init 这么说,
添加时 .claude/settings.local.json 去那个仓库 .gitignore。 。 。 .
最后会打印出你的公用钥匙和指纹. 送两个给调度员的管理员. 一直到 管理员添加了您的密钥。 再次打印它们:
npx @alterset/alterspec-client key
调度器的工具出现在寄存器中开始的下一个克洛德代码会话中.
init 别碰你 CLAUDE.md让克洛德知道出口在哪里 以及如何在出口区之外处理
技能也一样,复制块 agent-instructions.md (在这个包裹)进入你的经纪人
指示,无论你存放在哪里.
工作日
你和克洛德・克洛德・克洛德说话 技能是叫调度员和CLI.
-
开工去.
/alterspec-task-next或者"给我下一个任务" 立即指定一个音轨或请求几个音轨:/alterspec-task-next BE 2。它只分配:它继续完成一项任务,继续完成摘要,并列出几项任务 它们; 类型/alterspec-task-context <task>无论你们在什么地方工作 它不创造树枝,也不创造任何树干 工作由您选择( y)worktree <task>做一个当你想要的. -
从简取出.
/alterspec-task-context [task]读取导出的任务摘要 :- * 核对表,包括调度员已经持有的物品以及每件物品的变化;
- 为何作出改变;
- 每个物体的前后;
- 页:1
BE: 更改清单和操作的接受标准,整体;规则和事件 核对表的标准或更改的文本名称,整体;其他的能力名称,作为路径; - 页:1
BE能力所在的实体作为路径; - 决定和术语表 更改的文本名称,整体;其他决定其对象名称,如 路径;
- 对于一个UI轨道:屏幕,他们的体验合同,模拟页和设计系统.
你用自己的技术建造它 当谱系沉默或不同意代码时,克洛德会问你;它确实如此 不是发明商业规则。 模拟页面显示商定的外观和行为。 复制不是密码 .
-
准备拖车. 任务的每一项承诺都以下列内容为结束:
Alterspec-Task: CHG-012/BE Alterspec-Covers: CAP-CAT-001-AC-03, CAP-CAT-002Alterspec-Task每一个承诺.Alterspec-Covers只有承诺 使一个物品的测试通过, 准确如清单所写的那样命名项目。 列出每件物品一次;无任何内容的承诺没有Alterspec-Covers线条。 每人承诺后,向调度员报告被覆盖的物品。 它的工作在 永远不要挡住你 当报告没有变化或者最后一份报告不到15分钟时,它就跳过了报告 老样子. -
合并,然后报告完成. 一旦任务的工作进入轨道主分支 远程,类型
/alterspec-task-done CHG-012/BE它发出最后的进展,找到带来任务的承诺,以及 报告它做了。 在未合并工作时拒绝.
其他技能:
| 技能 | 它会做什么 |
|---|---|
/alterspec-task-status [track] | 您的任务有进步和ETA,什么是可用的,什么是被阻挡的,什么是什么,以及每个关卡的开放变化. |
/alterspec-task-eta <task> <YYYY-MM-DD|clear> <reason> | 为自己的任务设定日期, 或 clear 所以调度员计算出的ETA又适用了. |
/alterspec-task-release <task> [reason] | 给一个任务回来。 你的密码和分枝保持不变. |
/alterspec-spec-ask <question> | 回答出口产品的问题,引用身份证。 唯相读取. |
你只打过字 task-done, (中文(简体) ), task-eta 财务报告和审定财务报表 task-release 你自己,因为每个人都是你的保证。 克劳德开始
其他人也来自普通语言.
图标
这些技能是用来操作的;你很少自己需要这些技能。 在仓库或工作树上运行它们。 在任务中 工作树,配置从主检出处读取.
| 命令 | 它会做什么 |
|---|---|
init [options] | 设置仓库(见上文). |
key | 打印公用钥匙和指纹. |
open dispatcher | 在浏览器中签名并打开调度器的页面. 连通一次,一分钟. |
context <task> [--json] [--stats] | 从出口中打印任务简介,从问题和清单开始. |
worktree <task> [--here] | 创建分支 task/<chg>-<track> 从 origin/<main> 在它自己的工作树上, 与检查结果的 git-ignored 顶级的连锁 和它的 承诺的相对解决. --here 使用此取出. |
progress [task] [--json] | 报告你承诺的封面 默认: 当前分支的任务 . |
lookup [ref...] [--question <text>] [--task <task>] [--item <item>] | 在出口中,问题在哪里得到回答:首先要读什么,在叫出口沉默之前要打开什么,是邻居. --unread <path...> 说什么没有打开. |
cites <ref...> | 请检查date=中的日期值 (帮助) 每个ID或路径都在导出中;"从谱"的答案必须经过什么. |
questions [task] [--about <ID...>] [--open] [--json] | 用产品方的答案打印一个任务的问题, 给一些ID命名, 或没有你自己的. |
merged <task> | 打印承诺 origin/<main> 这带来了任务. |
export-head [--latest <sha>] | 拉出输出克隆并打印承诺发送到调度器. |
mcp | MCP 服务器 Claude 代码从 .mcp.json它向调度员前进. |
每个运行为 npx @alterset/alterspec-client <command>。 。 。 .
解决问题
- "调度员拒绝了你的SSH密钥": 管理员尚未添加您的密钥, 或者您正在与一个
不同的钥匙。 发送其打印的两行(或
key)给管理者. - "没有 SSH 密钥可以签名": 添加一个
ssh-ed25519键以创建 ssh-agent~/.ssh/id_ed25519,或设置key内.alterspec-client.json。 。 。 . - "ssh -agent没有钥匙": 运行
ssh-add用于配置的密钥. - Claude 代码中没有调度工具页:1
dispatcher服务器没有被批准或装入。 运行init再来 批准进去.claude/settings.local.json),确保git不跟踪该文件(git rm --cached如果是init然后开始新的会话。 互动claude终端,/mcp显示 服务器的状态并批准它. - "没有... : 运行
init在此寄存器中, 或将配置输入工作树 找到它。 发现它. - "出口是N承诺落后":克隆人追不上. 任务已经改变,所以工作 继续说 检查克隆人的远程 如果它一直发生.
- 报告为未知的物项页:1
Alterspec-Covers线条命名了清单所缺少的东西。 一个被逼迫的 无法改正; 请在以后的动作中指定正确的项目 . task-done说工作没有合并: 将任务的分支合并到主分支中, 或推动承诺 携带其Alterspec-Task拖车,然后运行它再次.
对于调度员: work.json 格式
import { parseWork, WorkSchema, AnyWorkSchema, WorkError } from '@alterset/alterspec-client/work';
parseWork(text) 读取 work.json 格式 1 或 2 并投掷 WorkError 当它不是一个。 JSON斯克马是
时间 @alterset/alterspec-client/work.schema.json。 。 。 .
许可证
麻省理工学院,Alterset d.o.