mcpField
P
project-tickets

project-tickets

github.com/light-chengAgent 工作流521 次安装4 天前更新
代码仓库

关于 project-tickets

project-tickets 是一项由用户明确调用的规划技能，可将已批准的 SPEC 转为本地 Markdown 跟踪器中的编号问题。它会核验交接内容、拟定带依赖关系的垂直切片，并在用户批准方案后发布工单。

主要功能

  1. 01核验 SPEC 的批准状态与完整性
  2. 02拟定可演示的垂直切片工单
  3. 03标注依赖关系与并行工作
  4. 04与用户迭代工单结构
  5. 05发布编号 Markdown 问题文件

适用场景

  1. 01将已批准的 SPEC 转为实施工单
  2. 02规划具有明确依赖关系的工作
  3. 03将已批准的变更提案应用到工单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/light-cheng/skills --skill project-tickets

安装后在 Claude Code 中输入/project-tickets确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

ATTRIBUTION.md
agents/
openai.yaml
references/
EXAMPLES.md
TICKET-CONTRACT.md
WORKFLOW.md

详细介绍

项目工单

project-tickets 是一个由用户明确发起的规划阶段。仅在收到明确的 $project-tickets 请求后运行。它会将已验证的 SPEC 转换为编号工单，每张工单对应一个文件，并写入本地 Markdown 跟踪器。

根据 docs/agents/light-project.md 以及其中的 docs/agents/issue-tracker.md 定位文件（如存在），确定跟踪器和工作区。如果配置的跟踪器不符合受支持的本地 Markdown 合约，请报告 BLOCKED，并指出缺少的适配器，而不是悄悄写入 .scratch 文件。

核心行为

  1. 验证 SPEC 交接。 阅读提供路径上的 SPEC；如果 SPEC 缺失、格式错误或 Approval: pending，则视为交接存在缺口——报告问题并停止。如果 SPEC 中没有 Approval: 行：询问用户，并在用户同意后记录。
  2. 起草 tracer-bullet 纵向切片。 每个切片都是贯穿相关层级的狭窄、完整且可演示的路径，包含 Blocked by 依赖、ready work 和 parallelizable 分组。
  3. 询问用户。 展示标题、Blocked by 依赖项，以及每张工单交付的内容；反复修改，直到用户批准粒度和依赖关系。
  4. 每张工单发布一个文件到 .scratch/<feature>/issues/，按依赖顺序从 01 开始编号，并保持已批准的格式不变。然后将批准信息（批准人、时间、原话）作为 Tickets approved 行追加到 SPEC 的 ## Comments 中。

应用变更提案。 用户传入 .scratch/<feature>/changes/ 中已 approved 的提案时，严格按其 Tickets: 行应用变更（添加、删除、拆分、重排、修改 Blocked by 或验收标准）。当其 SPEC: 行为 none，或 ## Comments 下已经有 SPEC applied 行时，将 **Status:** 设为 applied 并添加状态行；否则添加 - <date> Tickets applied — project-tickets。如果提案处于其他状态，或要应用的变更未列出，则保持原样交还用户。

交接

发布后，说明当前可推进的前沿，并建议用户对选定工单明确发起 $light-implement，然后停止。

可选功能

  • 存在 .scratch/<feature>/plan.html → 发布后，调用 light-html-plan 刷新该页面。页面或功能缺失时跳过。

参考资料

评论

支持 Markdown