@fitlab-ai/agent-infra 0.5.1 → 0.5.3

package/templates/.agents/rules/issue-pr-commands.github.en.md

@@ -0,0 +1,111 @@
+# Issue / PR Platform Commands
+
+Read this file before verifying platform authentication, reading Issues / PRs, or creating and updating Issues / PRs.
+
+## Authentication and Repository Info
+
+Verify that GitHub CLI is available and authenticated:
+
+```bash
+gh auth status
+gh repo view --json nameWithOwner
+```
+
+If either command fails, stop or degrade according to the calling skill.
+
+## Read and Create Issues
+
+Read an Issue:
+
+```bash
+gh issue view {issue-number} --json number,title,body,labels,state,milestone,url
+```
+
+Create an Issue:
+
+```bash
+gh issue create --title "{title}" --body "{body}" --assignee @me {label-args} {milestone-arg}
+```
+
+- expand `{label-args}` into repeated `--label` flags from the validated label list
+- omit all `--label` flags when nothing valid remains
+- omit `{milestone-arg}` entirely when no milestone should be set
+
+Set the Issue Type:
+
+```bash
+gh api "orgs/{owner}/issue-types" --jq '.[].name'
+gh api "repos/{owner}/{repo}/issues/{issue-number}" -X PATCH -f type="{issue-type}" --silent
+```
+
+## Update Issues
+
+Use this shape when updating titles, labels, assignees, or milestones:
+
+```bash
+gh issue edit {issue-number} {edit-args}
+```
+
+Common arguments:
+- `--title "{title}"`
+- `--add-label "{label}"`
+- `--remove-label "{label}"`
+- `--add-assignee @me`
+- `--milestone "{milestone}"`
+
+Close an Issue:
+
+```bash
+gh issue close {issue-number} --reason "{reason}"
+```
+
+## Read Issue Comments
+
+Read Issue comments or search for existing hidden markers:
+
+```bash
+gh api "repos/{owner}/{repo}/issues/{issue-number}/comments" --paginate
+```
+
+## Read and Create PRs
+
+Read a PR:
+
+```bash
+gh pr view {pr-number} --json number,title,body,labels,state,milestone,url,files
+```
+
+List PRs:
+
+```bash
+gh pr list --state {state} --base {base-branch} --json number,title,url,headRefName,baseRefName
+```
+
+Create a PR:
+
+```bash
+gh pr create --base "{target-branch}" --title "{title}" --assignee @me --body "$(cat <<'EOF'
+{pr-body}
+EOF
+)"
+```
+
+## Update PRs
+
+Update PR titles, labels, or milestones with:
+
+```bash
+gh pr edit {pr-number} {edit-args}
+```
+
+Common arguments:
+- `--title "{title}"`
+- `--add-label "{label}"`
+- `--remove-label "{label}"`
+- `--milestone "{milestone}"`
+
+## Error Handling
+
+- read failures: stop or skip based on the calling skill
+- update failures: warn and continue when the caller marks the action as best-effort
+- `@me` is resolved by `gh` CLI to the authenticated user

package/templates/.agents/rules/issue-pr-commands.github.zh-CN.md

@@ -0,0 +1,111 @@
+# Issue / PR 平台命令
+
+在需要验证平台认证、读取 Issue / PR，或执行 Issue / PR 创建与更新前先读取本文件。
+
+## 认证与仓库信息
+
+先验证 GitHub CLI 可用且已认证：
+
+```bash
+gh auth status
+gh repo view --json nameWithOwner
+```
+
+如果任一命令失败，按调用该规则的 skill 约定停止或降级。
+
+## Issue 读取与创建
+
+读取 Issue：
+
+```bash
+gh issue view {issue-number} --json number,title,body,labels,state,milestone,url
+```
+
+创建 Issue：
+
+```bash
+gh issue create --title "{title}" --body "{body}" --assignee @me {label-args} {milestone-arg}
+```
+
+- `{label-args}` 由调用方按有效 label 列表展开为多个 `--label`
+- 没有有效 label 时省略全部 `--label`
+- `{milestone-arg}` 为空时整体省略
+
+设置 Issue Type：
+
+```bash
+gh api "orgs/{owner}/issue-types" --jq '.[].name'
+gh api "repos/{owner}/{repo}/issues/{issue-number}" -X PATCH -f type="{issue-type}" --silent
+```
+
+## Issue 更新
+
+更新标题、label、assignee 或 milestone 时使用：
+
+```bash
+gh issue edit {issue-number} {edit-args}
+```
+
+常见参数：
+- `--title "{title}"`
+- `--add-label "{label}"`
+- `--remove-label "{label}"`
+- `--add-assignee @me`
+- `--milestone "{milestone}"`
+
+关闭 Issue：
+
+```bash
+gh issue close {issue-number} --reason "{reason}"
+```
+
+## Issue 评论读取
+
+读取 Issue 评论或按隐藏标记查找已有评论：
+
+```bash
+gh api "repos/{owner}/{repo}/issues/{issue-number}/comments" --paginate
+```
+
+## PR 读取与创建
+
+读取 PR：
+
+```bash
+gh pr view {pr-number} --json number,title,body,labels,state,milestone,url,files
+```
+
+列出 PR：
+
+```bash
+gh pr list --state {state} --base {base-branch} --json number,title,url,headRefName,baseRefName
+```
+
+创建 PR：
+
+```bash
+gh pr create --base "{target-branch}" --title "{title}" --assignee @me --body "$(cat <<'EOF'
+{pr-body}
+EOF
+)"
+```
+
+## PR 更新
+
+更新 PR 标题、label 或 milestone：
+
+```bash
+gh pr edit {pr-number} {edit-args}
+```
+
+常见参数：
+- `--title "{title}"`
+- `--add-label "{label}"`
+- `--remove-label "{label}"`
+- `--milestone "{milestone}"`
+
+## 错误处理
+
+- 读取失败：按调用方规则决定停止还是跳过
+- 更新失败：如果调用方标记为 best-effort，输出警告并继续
+- `@me` 由 `gh` CLI 解析为当前认证用户

package/templates/.agents/rules/label-milestone-setup.github.en.md

@@ -0,0 +1,50 @@
+# Label / Milestone Platform Commands
+
+Read this file before initializing labels, initializing milestones, or adjusting milestones during release work.
+
+## Authentication and Repository Info
+
+```bash
+gh auth token
+gh repo view --json nameWithOwner --jq '.nameWithOwner'
+```
+
+## Label Operations
+
+List existing labels:
+
+```bash
+gh label list --limit 200 --json name --jq '.[].name'
+```
+
+Create or update a label:
+
+```bash
+gh label create "{name}" --color "{color}" --description "{description}" --force
+```
+
+## Milestone Operations
+
+List milestones:
+
+```bash
+gh api "repos/$repo/milestones?state=all" --paginate
+```
+
+Create a milestone:
+
+```bash
+gh api "repos/$repo/milestones" -f title="{title}" -f description="{description}" -f state="{state}"
+```
+
+Update a milestone:
+
+```bash
+gh api "repos/$repo/milestones/{number}" -X PATCH -f state="{state}" -f description="{description}"
+```
+
+## Constraints
+
+- use label names as the idempotency key
+- use milestone titles as the idempotency key, then milestone numbers when patching state
+- stop or skip according to the calling skill when commands fail

package/templates/.agents/rules/label-milestone-setup.github.zh-CN.md

@@ -0,0 +1,50 @@
+# Label / Milestone 平台命令
+
+在初始化 label、初始化 milestone，或发布流程需要调整 milestone 前先读取本文件。
+
+## 认证与仓库信息
+
+```bash
+gh auth token
+gh repo view --json nameWithOwner --jq '.nameWithOwner'
+```
+
+## Label 操作
+
+列出现有 label：
+
+```bash
+gh label list --limit 200 --json name --jq '.[].name'
+```
+
+创建或更新 label：
+
+```bash
+gh label create "{name}" --color "{color}" --description "{description}" --force
+```
+
+## Milestone 操作
+
+列出 milestone：
+
+```bash
+gh api "repos/$repo/milestones?state=all" --paginate
+```
+
+创建 milestone：
+
+```bash
+gh api "repos/$repo/milestones" -f title="{title}" -f description="{description}" -f state="{state}"
+```
+
+更新 milestone：
+
+```bash
+gh api "repos/$repo/milestones/{number}" -X PATCH -f state="{state}" -f description="{description}"
+```
+
+## 约束
+
+- label 以名称作为幂等键
+- milestone 以标题作为幂等键，必要时再结合编号更新状态
+- 失败时按调用方规则决定停止或跳过

package/templates/.agents/rules/release-commands.github.en.md

@@ -0,0 +1,30 @@
+# Release Platform Commands
+
+Read this file before loading release history, querying merged PRs, or creating a draft release.
+
+## Query Releases
+
+```bash
+gh release list --limit {limit} --json tagName,isDraft,isPrerelease
+gh release view "{tag}" --json body,url
+```
+
+## Query Merged PRs
+
+```bash
+gh pr list --state merged --base "{branch}" --json number,title,mergedAt,labels
+```
+
+When needed, read the linked Issue:
+
+```bash
+gh issue view {issue-number} --json number,title,labels,url
+```
+
+## Create a Draft Release
+
+```bash
+gh release create "v{version}" --draft --title "v{version}" --notes-file "{notes-file}"
+```
+
+If commands fail, stop or escalate according to the calling skill.

package/templates/.agents/rules/release-commands.github.zh-CN.md

@@ -0,0 +1,30 @@
+# Release 平台命令
+
+在读取历史 release、查询已合并 PR，或创建 draft release 前先读取本文件。
+
+## Release 查询
+
+```bash
+gh release list --limit {limit} --json tagName,isDraft,isPrerelease
+gh release view "{tag}" --json body,url
+```
+
+## 已合并 PR 查询
+
+```bash
+gh pr list --state merged --base "{branch}" --json number,title,mergedAt,labels
+```
+
+必要时读取关联 Issue：
+
+```bash
+gh issue view {issue-number} --json number,title,labels,url
+```
+
+## 创建 Draft Release
+
+```bash
+gh release create "v{version}" --draft --title "v{version}" --notes-file "{notes-file}"
+```
+
+失败时按调用方规则停止或提示人工介入。

package/templates/.agents/rules/security-alerts.github.en.md

@@ -0,0 +1,43 @@
+# Security Alert Platform Commands
+
+Read this file before importing or dismissing Dependabot or Code Scanning alerts.
+
+## Dependabot Alerts
+
+Read an alert:
+
+```bash
+gh api "repos/{owner}/{repo}/dependabot/alerts/{number}"
+```
+
+Dismiss an alert:
+
+```bash
+gh api --method PATCH "repos/{owner}/{repo}/dependabot/alerts/{number}" \
+  -f state="dismissed" \
+  -f dismissed_reason="{reason}" \
+  -f dismissed_comment="{comment}"
+```
+
+## Code Scanning Alerts
+
+Read an alert:
+
+```bash
+gh api "repos/{owner}/{repo}/code-scanning/alerts/{number}"
+```
+
+Dismiss an alert:
+
+```bash
+gh api --method PATCH "repos/{owner}/{repo}/code-scanning/alerts/{number}" \
+  -f state="dismissed" \
+  -f dismissed_reason="{reason}" \
+  -f dismissed_comment="{comment}"
+```
+
+## Constraints
+
+- read the current alert state before deciding whether to continue
+- validate dismissal reasons in the calling skill before sending them
+- stop or escalate according to the calling skill when API calls fail

package/templates/.agents/rules/security-alerts.github.zh-CN.md

@@ -0,0 +1,43 @@
+# 安全告警平台命令
+
+在导入或关闭 Dependabot / Code Scanning 告警前先读取本文件。
+
+## Dependabot 告警
+
+读取告警：
+
+```bash
+gh api "repos/{owner}/{repo}/dependabot/alerts/{number}"
+```
+
+关闭告警：
+
+```bash
+gh api --method PATCH "repos/{owner}/{repo}/dependabot/alerts/{number}" \
+  -f state="dismissed" \
+  -f dismissed_reason="{reason}" \
+  -f dismissed_comment="{comment}"
+```
+
+## Code Scanning 告警
+
+读取告警：
+
+```bash
+gh api "repos/{owner}/{repo}/code-scanning/alerts/{number}"
+```
+
+关闭告警：
+
+```bash
+gh api --method PATCH "repos/{owner}/{repo}/code-scanning/alerts/{number}" \
+  -f state="dismissed" \
+  -f dismissed_reason="{reason}" \
+  -f dismissed_comment="{comment}"
+```
+
+## 约束
+
+- 先读取当前告警状态，再决定是否继续
+- 关闭理由必须由调用方校验后再传入
+- API 失败时按调用方规则停止或提示人工介入

package/templates/.agents/scripts/validate-artifact.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
@@ -31,8 +29,8 @@ const DEFAULT_REQUIRED_FIELDS = [
 
 const DEFAULT_RETRY_DELAYS_MS = [3000, 10000];
 const DEFAULT_FRESHNESS_MINUTES = 30;
-const DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/;
-const ACTIVITY_LOG_PATTERN = /^- (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}) — \*\*(.+?)\*\* by (.+?) — (.+)$/;
+const DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:[+-]\d{2}:\d{2})?$/;
+const ACTIVITY_LOG_PATTERN = /^- (\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:[+-]\d{2}:\d{2})?) — \*\*(.+?)\*\* by (.+?) — (.+)$/;
 const BRANCH_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 
 const scriptPath = fileURLToPath(import.meta.url);
@@ -1353,7 +1351,7 @@ function sleep(delayMs) {
 // === Utilities ===
 
 function minutesSinceTimestamp(timestamp) {
-  const normalized = timestamp.replace(" ", "T");
+  const normalized = timestamp.includes("T") ? timestamp : timestamp.replace(" ", "T");
   const parsed = Date.parse(normalized);
   if (Number.isNaN(parsed)) {
     return Number.POSITIVE_INFINITY;

package/templates/.agents/skills/analyze-task/{SKILL.md → SKILL.en.md}

@@ -103,7 +103,7 @@ Create `.agents/workspace/active/{task-id}/{analysis-artifact}`.
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S"
+date "+%Y-%m-%d %H:%M:%S%:z"
 ```
 
 Update `.agents/workspace/active/{task-id}/task.md`:
@@ -115,7 +115,7 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 - Mark requirement-analysis as complete in workflow progress and include the actual round when the task template supports it
 - **Append** to `## Activity Log` (do NOT overwrite previous entries):
   ```
-  - {yyyy-MM-dd HH:mm:ss} — **Requirement Analysis (Round {N})** by {agent} — Analysis completed → {analysis-artifact}
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Requirement Analysis (Round {N})** by {agent} — Analysis completed → {analysis-artifact}
   ```
 
 If task.md contains a valid `issue_number`, perform these sync actions (skip and continue on any failure):

package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md

@@ -103,7 +103,7 @@ description: "分析任务并输出需求分析文档"
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S"
+date "+%Y-%m-%d %H:%M:%S%:z"
 ```
 
 更新 `.agents/workspace/active/{task-id}/task.md`：
@@ -115,7 +115,7 @@ date "+%Y-%m-%d %H:%M:%S"
 - 在工作流进度中标记 requirement-analysis 为已完成，并注明实际轮次（如果任务模板支持）
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
   ```
-  - {yyyy-MM-dd HH:mm:ss} — **Requirement Analysis (Round {N})** by {agent} — Analysis completed → {analysis-artifact}
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Requirement Analysis (Round {N})** by {agent} — Analysis completed → {analysis-artifact}
   ```
 
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：

package/templates/.agents/skills/archive-tasks/scripts/archive-tasks.sh

@@ -210,7 +210,7 @@ rebuild_manifest() {
   entries_file="$tmpdir/manifest.tsv"
   month_keys_file="$tmpdir/manifest-months.tsv"
   year_keys_file="$tmpdir/manifest-years.tsv"
-  generated_at=$(date "+%Y-%m-%d %H:%M:%S")
+  generated_at=$(date "+%Y-%m-%d %H:%M:%S%:z")
 
   mkdir -p "$ARCHIVE_DIR"
   : > "$entries_file"

package/templates/.agents/skills/block-task/{SKILL.md → SKILL.en.md}

@@ -40,7 +40,7 @@ Before blocking, thoroughly analyze:
 Get the current time:
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S"
+date "+%Y-%m-%d %H:%M:%S%:z"
 ```
 
 Update `.agents/workspace/active/{task-id}/task.md`:
@@ -49,7 +49,7 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 - `updated_at`: {current timestamp}
 - **Append** to `## Activity Log` (do NOT overwrite previous entries):
   ```
-  - {yyyy-MM-dd HH:mm:ss} — **Blocked** by {agent} — {one-line reason}
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Blocked** by {agent} — {one-line reason}
   ```
 
 Add a blocking information section to task.md.

package/templates/.agents/skills/block-task/SKILL.zh-CN.md

@@ -40,7 +40,7 @@ description: "标记任务为阻塞状态并记录原因"
 获取当前时间：
 
 ```bash
-date "+%Y-%m-%d %H:%M:%S"
+date "+%Y-%m-%d %H:%M:%S%:z"
 ```
 
 更新 `.agents/workspace/active/{task-id}/task.md`：
@@ -49,7 +49,7 @@ date "+%Y-%m-%d %H:%M:%S"
 - `updated_at`：{当前时间戳}
 - **追加**到 `## Activity Log`（不要覆盖之前的记录）：
   ```
-  - {yyyy-MM-dd HH:mm:ss} — **Blocked** by {agent} — {一行原因}
+  - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Blocked** by {agent} — {一行原因}
   ```
 
 在 task.md 中添加阻塞信息部分。