task-specification-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Task Specification Creator

任务规范创建工具

開発タスクを Phase 1〜13 の実行可能な仕様書へ落とし込む。
SKILL.md
は入口だけを持ち、詳細は
references/
LOGS.md
に分離する。
将开发任务转化为Phase 1~13的可执行规范文档。
SKILL.md
仅作为入口,详细内容拆分至
references/
LOGS.md
中。

設計原則

设计原则

原則説明
Script First決定論的処理は
scripts/
で固定する
LLM for Judgment判断、設計、レビューだけを LLM が担う
Progressive Disclosure必要な reference だけを段階的に読む
1 File = 1 Responsibility大きくなった guide は family file へ分離する
.claude
Canonical
正本は
.claude/skills/...
.agents/skills/...
は mirror
原则说明
脚本优先确定性处理逻辑固定在
scripts/
目录中
大语言模型负责判断仅由LLM承担判断、设计、评审工作
渐进式披露仅逐步读取必要的参考资料
单文件单职责内容过多的指南拆分至系列文件中
.claude
为正本
正本存储于
.claude/skills/...
.agents/skills/...
为镜像副本

クイックスタート

快速入门

モード用途最初に読むもの
create
新規 workflow を作るreferences/create-workflow.md
execute
Phase 1〜13 を順番に実行するreferences/execute-workflow.md
update
既存仕様書を修正するreferences/phase-templates.md
detect-unassigned
Phase 12 の残課題を formalize するreferences/phase-12-documentation-guide.md
bash
node scripts/detect-mode.js --request "{{USER_REQUEST}}"
模式用途优先阅读内容
create
创建新工作流references/create-workflow.md
execute
依次执行Phase 1~13references/execute-workflow.md
update
修改现有规范文档references/phase-templates.md
detect-unassigned
规范化Phase 12的遗留任务references/phase-12-documentation-guide.md
bash
node scripts/detect-mode.js --request "{{USER_REQUEST}}"

実行フロー

执行流程

create

创建模式

  1. agents/decompose-task.md
    で責務を分解する。
  2. agents/identify-scope.md
    で前提、制約、受入条件を固定する。
  3. agents/design-phases.md
    agents/generate-task-specs.md
    index.md
    phase-*.md
    を作る。
  4. agents/output-phase-files.md
    agents/update-dependencies.md
    artifacts.json
    を整える。
  5. agents/verify-specs.md
    scripts/validate-phase-output.js
    scripts/verify-all-specs.js
    で gate を通す。
  1. agents/decompose-task.md
    中分解任务职责。
  2. agents/identify-scope.md
    中固定前提、约束和验收条件。
  3. 通过
    agents/design-phases.md
    agents/generate-task-specs.md
    生成
    index.md
    phase-*.md
  4. 通过
    agents/output-phase-files.md
    agents/update-dependencies.md
    整理
    artifacts.json
  5. 通过
    agents/verify-specs.md
    scripts/validate-phase-output.js
    scripts/verify-all-specs.js
    通过阶段门控。

execute

执行模式

Phase名称目的
1要件定義scope、受入条件、inventory を固定する
2設計topology、SubAgent lane、validation path を設計する
3設計レビューPhase 4 へ進めるかを判定する
4テスト作成command suite と expected result を作る
5実装
.claude
正本を更新し、mirror を同期する
6テスト拡充fail path、回帰 guard、補助 command を追加する
7カバレッジ確認concern と dependency edge の coverage を可視化する
8リファクタリングduplicate と navigation drift を削る
9品質保証line budget、link、mirror parity を一括判定する
10最終レビューacceptance criteria と blocker を判定する
11手動テストdocs navigation と UI evidence を人手で確認する
12ドキュメント更新implementation guide、spec sync、未タスク、feedback を完了する
13PR作成user の明示承認後のみ実施する
Phase名称目的
1需求定义固定范围、验收条件和资源清单
2设计设计拓扑结构、SubAgent流程线、验证路径
3设计评审判断是否进入Phase 4
4测试用例创建生成命令套件和预期结果
5实现更新
.claude
正本并同步镜像副本
6测试扩展添加异常路径、回归防护、辅助命令
7覆盖率确认可视化关注点和依赖边缘的覆盖率
8重构消除重复代码和导航偏移
9质量保证批量判定代码行数预算、链接、镜像一致性
10最终评审判定验收标准和阻塞问题
11手动测试人工确认文档导航和UI验证证据
12文档更新完成实现指南、规范同步、未分配任务、反馈收集
13创建PR仅在获得用户明确批准后执行

Task仕様ナビ

任务规范导航

Task責務パターン入力出力
decompose-taskタスクを単一責務に分解seqユーザー要求タスク分解リスト
identify-scopeスコープ・前提・制約を定義seqタスク分解リストスコープ定義
design-phasesPhase構成を設計seqスコープ定義フェーズ設計書
generate-task-specsタスク仕様書を生成seqフェーズ設計書タスク仕様書一覧
output-phase-files個別Markdownファイルを出力parタスク仕様書一覧phase-*.md
update-dependenciesPhase間の依存関係を設定parタスク仕様書一覧依存関係マップ
verify-specs全13仕様書の品質検証seq検証レポートPASS/FAIL判定
update-system-specsシステム仕様書を更新seq実装サマリー更新完了チェック
generate-unassigned-task未完了タスク指示書を生成condレビュー課題unassigned-task/*.md
凡例:
seq
=順次実行,
par
=並列実行,
cond
=条件分岐

任务职责模式输入输出
decompose-task将任务分解为单一职责单元seq用户要求任务分解列表
identify-scope定义范围、前提、约束seq任务分解列表范围定义
design-phases设计Phase结构seq范围定义阶段设计文档
generate-task-specs生成任务规范文档seq阶段设计文档任务规范文档集合
output-phase-files输出独立Markdown文件par任务规范文档集合phase-*.md
update-dependencies设置Phase间的依赖关系par任务规范文档集合依赖关系映射
verify-specs验证全部13份规范文档的质量seq验证报告PASS/FAIL判定
update-system-specs更新系统规范文档seq实现总结更新完成检查
generate-unassigned-task生成未完成任务指示书cond评审问题unassigned-task/*.md
图例:
seq
=顺序执行,
par
=并行执行,
cond
=条件分支

Phase 12 重要仕様

Phase 12 重要规范

必須タスク(5タスク - 全て完了必須)

必选任务(5项 - 全部必须完成)

Task名称必須詳細参照
1実装ガイド作成(2パート構成)下記参照
2システム仕様書更新(2ステップ)下記参照
3ドキュメント更新履歴作成scripts/generate-documentation-changelog.js
4未タスク検出レポート作成0件でも出力必須
5スキルフィードバックレポート作成改善点なしでも出力必須

任务名称必选详细参照
1实现指南创建(2部分结构)下文参照
2系统规范文档更新(2步骤)下文参照
3创建文档更新历史scripts/generate-documentation-changelog.js
4创建未分配任务检测报告即使0件也必须输出
5创建技能反馈报告即使无改进点也必须输出

Task 1: 実装ガイドの2パート構成

任务1: 实现指南的2部分结构

パート対象読者内容
Part 1初学者・中学生レベル概念説明(日常の例え話、専門用語なし)
Part 2開発者・技術者技術的詳細(スキーマ・API・コード例)
Part 1(中学生レベル)の必須要件:
  • 日常生活での例え話を必ず含める
  • 専門用語は使わない(使う場合は即座に説明)
  • 「なぜ必要か」を先に説明してから「何をするか」を説明
Part 2(技術者レベル)の必須要件:
  • インターフェース/型定義(TypeScript)を含める
  • APIシグネチャと使用例を記載
  • エラーハンドリングとエッジケースを説明
  • 設定可能なパラメータと定数を一覧化

部分目标读者内容
Part 1初学者・中学生水平概念说明(使用日常类比,无专业术语)
Part 2开发者・技术人员技术细节(Schema・API・代码示例)
Part 1(中学生水平)的必选要求:
  • 必须包含日常生活中的类比示例
  • 不使用专业术语(若使用需立即解释)
  • 先说明「为什么需要」,再解释「做什么」
Part 2(技术人员水平)的必选要求:
  • 包含接口/类型定义(TypeScript)
  • 记录API签名和使用示例
  • 说明错误处理和边缘场景
  • 列出可配置参数和常量

Task 2: システム仕様更新【4サブステップ + 条件付きStep 2】

任务2: 系统规范更新【4个子步骤 + 条件式Step 2】

Step必須内容
Step 1-Aタスク完了記録(「完了タスク」セクション追加 + 関連ドキュメントリンク + 変更履歴 + LOGS.md×2 + topic-map.md)
Step 1-B実装状況テーブル更新(実装完了:「未実装」→「完了」 / 仕様書作成のみ:
spec_created
Step 1-C関連タスクテーブル更新(仕様書内の「関連タスク」「未タスク候補」テーブルのステータス更新)
Step 2条件システム仕様更新(新規インターフェース追加時のみ)
⚠️ Task 1(実装ガイド作成)との境界に注意
活動Task 1(実装ガイド)Task 2(仕様更新)
Part 1/2 実装ガイド作成✅ メイン責務❌ 対象外
aiworkflow-requirements 仕様更新❌ 対象外✅ Step 2
タスク完了記録(仕様書内)❌ 対象外✅ Step 1-A 必須
LOGS.md更新(2ファイル)❌ 対象外✅ Step 1-A 必須
Step 2 更新が必要な場合:
  • 新規インターフェース/型の追加
  • 既存インターフェースの変更
  • 新規定数/設定値の追加
  • API仕様の変更
Step 2 更新が不要な場合:
  • 内部実装の詳細変更のみ
  • リファクタリング(インターフェース不変)
  • バグ修正(仕様変更なし)

步骤必选内容
Step 1-A任务完成记录(添加「已完成任务」章节 + 关联文档链接 + 变更历史 + 2份LOGS.md + topic-map.md)
Step 1-B更新实现状态表(实现完成:「未实现」→「已完成」 / 仅创建规范文档:
spec_created
Step 1-C更新关联任务表(更新规范文档中「关联任务」「未分配任务候选」表的状态)
Step 2条件更新系统规范(仅在添加新接口时执行)
⚠️ 注意与任务1(实现指南创建)的边界
活动任务1(实现指南)任务2(规范更新)
创建Part 1/2实现指南✅ 核心职责❌ 非目标范围
更新aiworkflow-requirements规范❌ 非目标范围✅ Step 2
记录任务完成情况(规范文档内)❌ 非目标范围✅ Step 1-A 必选
更新LOGS.md(2份文件)❌ 非目标范围✅ Step 1-A 必选
需要执行Step 2更新的场景:
  • 添加新接口/类型
  • 修改现有接口
  • 添加新常量/配置值
  • 修改API规范
无需执行Step 2更新的场景:
  • 仅修改内部实现细节
  • 重构(接口保持不变)
  • 修复Bug(无规范变更)

Task 4: 未タスク検出(0件でも出力必須)

任务4: 未分配任务检测(即使0件也必须输出)

ソース確認項目
元タスク仕様書「スコープ外」として明示された項目
Phase 3/10レビュー結果MINOR判定の指摘事項
Phase 11手動テストスコープ外の発見事項・改善提案
コードコメントTODO/FIXME/HACK/XXX
bash
undefined
来源检查项目
原始任务规范文档明确标记为「范围外」的项目
Phase 3/10评审结果MINOR判定的问题点
Phase 11手动测试范围外的发现事项・改进建议
代码注释TODO/FIXME/HACK/XXX
bash
undefined

未タスク検出スクリプト

未分配任务检测脚本

node scripts/detect-unassigned-tasks.js --scan packages/shared/src --output .tmp/unassigned-candidates.json

📖 [references/phase-11-12-guide.md](references/phase-11-12-guide.md)
📖 [references/spec-update-workflow.md](references/spec-update-workflow.md)
📖 [agents/generate-unassigned-task.md](agents/generate-unassigned-task.md)

---
node scripts/detect-unassigned-tasks.js --scan packages/shared/src --output .tmp/unassigned-candidates.json

📖 [references/phase-11-12-guide.md](references/phase-11-12-guide.md)
📖 [references/spec-update-workflow.md](references/spec-update-workflow.md)
📖 [agents/generate-unassigned-task.md](agents/generate-unassigned-task.md)

---

Task 5: スキルフィードバックレポート(改善点なしでも出力必須)

任务5: 技能反馈报告(即使无改进点也必须输出)

観点記録内容
テンプレート改善Phaseテンプレートの漏れや曖昧さ
ワークフロー改善機械検証や手順分岐の改善余地
ドキュメント改善再利用しやすい横断ガイドライン化の候補
出力:
  • outputs/phase-12/skill-feedback-report.md

维度记录内容
模板改进Phase模板的遗漏或模糊点
工作流改进机械验证或流程分支的优化空间
文档改进可复用的跨领域指南候选
输出:
  • outputs/phase-12/skill-feedback-report.md

Phase 12 実行時によくある漏れ

Phase 12 执行时常见遗漏

漏れパターン防止方法
Step 1-C(関連タスクテーブル)を未実行spec-update-workflow.md の「確認すべきファイル」表を実行前に必ず読む
topic-map.md 未更新仕様書に新規セクション追加時は必ず topic-map.md のエントリも追加
documentation-changelog.md が不完全全Step(1-A/1-B/1-C/Step 2)の結果を個別に明記する(「該当なし」も記録)
spec-update-summary.md
を未作成で完了扱い
Phase 12成果物一覧と
outputs/phase-12/
実体を1対1で突合し、不足ファイルは完了前に作成する
LOGS.md が1ファイルのみ更新必ず aiworkflow-requirements/LOGS.md と task-specification-creator/LOGS.md の両方
完了タスクセクションが簡略形式spec-update-workflow.md のテンプレート(テスト結果サマリー + 成果物テーブル)に従う
artifacts.json
outputs/artifacts.json
が不一致
Phase 12完了前に2ファイルを同期し、completed成果物の参照切れを0件にする
Phase 10 MINOR指摘を未タスク化せず進行Phase 10レビュー前に unassigned-task-guidelines.md を読み、MINOR判定→未タスク化ルールを確認
未タスク検出レポートで0件判定のまま未修正Phase 10 MINOR指摘は必ず未タスク化の対象。「機能に影響なし」は不要判定の理由にならない
task-workflow.md
の未タスクリンクが参照切れ
Step 1-E後に
verify-unassigned-links.js
を実行して
ALL_LINKS_EXIST
を確認する
遗漏模式预防方法
未执行Step 1-C(关联任务表)执行前务必阅读spec-update-workflow.md中的「需检查文件」表
未更新topic-map.md向规范文档添加新章节时,务必同步更新topic-map.md的条目
documentation-changelog.md内容不完整单独记录每个步骤(1-A/1-B/1-C/Step 2)的结果(「无相关内容」也需记录)
未创建
spec-update-summary.md
即标记完成
将Phase 12成果物列表与
outputs/phase-12/
实际文件逐一核对,完成前补充缺失文件
仅更新1份LOGS.md务必同时更新aiworkflow-requirements/LOGS.md和task-specification-creator/LOGS.md
已完成任务章节内容过于简略遵循spec-update-workflow.md中的模板(测试结果总结 + 成果物表格)
artifacts.json
outputs/artifacts.json
不一致
Phase 12完成前同步两份文件,确保已完成成果物无缺失引用
未将Phase 10的MINOR问题转化为未分配任务即推进Phase 10评审前阅读unassigned-task-guidelines.md,确认MINOR判定→未分配任务的规则
未分配任务检测报告中0件判定后未修正Phase 10的MINOR问题必须转化为未分配任务。「不影响功能」不能作为无需处理的理由
task-workflow.md
中的未分配任务链接失效
Step 1-E后执行
verify-unassigned-links.js
,确认
ALL_LINKS_EXIST

Phase 12 苦戦防止Tips

Phase 12 避免踩坑技巧

UT-STORE-HOOKS-COMPONENT-MIGRATION-001の経験に基づく(2026-02-12)
Tips説明
事前に空欄チェックリストを作成documentation-changelog.mdにStep 1-A〜1-D + Step 2の各欄を空欄で事前作成し、逐次消化する
spec-update-workflow.mdを常に参照Phase 12開始時に必ず spec-update-workflow.md を開き、チェックリストを確認
「全Step確認前に完了と記載しない」厳守P4パターン。全Stepの結果を個別に記録してから「Phase 12完了」とする
LOGS.md/SKILL.md は4ファイル更新aiworkflow-requirements/LOGS.md, task-specification-creator/LOGS.md, aiworkflow-requirements/SKILL.md, task-specification-creator/SKILL.md
topic-map.md再生成はセクション変更時も新規追加だけでなく、セクション更新・削除時も
node .claude/skills/aiworkflow-requirements/scripts/generate-index.js
node .claude/skills/task-specification-creator/scripts/generate-index.js --workflow docs/30-workflows/{{FEATURE_NAME}} --regenerate
を実行

基于UT-STORE-HOOKS-COMPONENT-MIGRATION-001的经验(2026-02-12)
技巧说明
提前创建空白检查表在documentation-changelog.md中提前创建Step 1-A~1-D + Step 2的空白栏,逐步填充内容
随时参考spec-update-workflow.mdPhase 12开始时务必打开spec-update-workflow.md,确认检查表
严格遵守「未确认全部步骤前不标记完成」P4模式。记录所有步骤的结果后,再标记「Phase 12完成」
LOGS.md/SKILL.md 需更新4份文件aiworkflow-requirements/LOGS.md, task-specification-creator/LOGS.md, aiworkflow-requirements/SKILL.md, task-specification-creator/SKILL.md
章节变更时也需重新生成topic-map.md不仅新增章节,更新/删除章节时也需执行
node .claude/skills/aiworkflow-requirements/scripts/generate-index.js
node .claude/skills/task-specification-creator/scripts/generate-index.js --workflow docs/30-workflows/{{FEATURE_NAME}} --regenerate

重要ルール

重要规则

Phase完了時の必須アクション

Phase完成时的必选操作

  1. タスク完全実行: Phase内で指定された全タスクを完全に実行
  2. 成果物確認: 全ての必須成果物が生成されていることを検証
  3. artifacts.json更新:
    complete-phase.js
    でPhase完了ステータスを更新
  4. 完了条件チェック: 各タスクを完遂した旨を必ず明記
  1. 完全执行任务: 完成Phase中指定的全部任务
  2. 确认成果物: 验证所有必选成果物已生成
  3. 更新artifacts.json: 通过
    complete-phase.js
    更新Phase完成状态
  4. 检查完成条件: 务必明确记录各任务已完成

PR作成に関する注意

PR创建注意事项

PR作成は自動実行しない。必ずユーザーの明示的な許可を得てから実行すること。
📖 references/commands.md - コマンド一覧

禁止自动创建PR。必须获得用户明确批准后再执行。
📖 references/commands.md - 命令列表

よく使うコマンド

常用命令

Task責務パターン入力出力
decompose-task
タスクを単一責務に分割
seq
ユーザー要求タスク分解リスト
identify-scope
スコープ、前提、制約を定義
seq
分解結果スコープ定義
design-phases
phase 構成と gate を設計
seq
scopephase 設計書
generate-task-specs
index.md
phase-*.md
を生成
seq
phase 設計書workflow 仕様一式
output-phase-files
phase ファイルを出力
par
仕様データ
phase-*.md
update-dependencies
artifacts.json
と依存関係を更新
par
phase 一式依存マップ
verify-specs
workflow 全体をレビュー
seq
仕様一式PASS/FAIL
update-system-specs
Phase 12 Task 2 を遂行
seq
実装結果仕様同期結果
generate-unassigned-task
残課題を task spec 化
cond
review 指摘
unassigned-task/*.md
凡例:
seq
= 順次、
par
= 並列、
cond
= 条件分岐。
任务职责模式输入输出
decompose-task
将任务拆分为单一职责单元
seq
用户要求任务分解列表
identify-scope
定义范围、前提、约束
seq
分解结果范围定义
design-phases
设计Phase结构和门控
seq
范围阶段设计文档
generate-task-specs
生成
index.md
phase-*.md
seq
阶段设计文档完整工作流规范
output-phase-files
输出Phase文件
par
规范数据
phase-*.md
update-dependencies
更新
artifacts.json
和依赖关系
par
完整Phase集合依赖映射
verify-specs
评审整个工作流
seq
完整规范集合PASS/FAIL
update-system-specs
执行Phase 12 任务2
seq
实现结果规范同步结果
generate-unassigned-task
将遗留问题转化为任务规范
cond
评审意见
unassigned-task/*.md
图例:
seq
= 顺序执行,
par
= 并行执行,
cond
= 条件分支。

agent 導線

Agent导航

  • agents/decompose-task.md
  • agents/identify-scope.md
  • agents/design-phases.md
  • agents/generate-task-specs.md
  • agents/output-phase-files.md
  • agents/update-dependencies.md
  • agents/verify-specs.md
  • agents/update-system-specs.md
  • agents/generate-unassigned-task.md
  • agents/decompose-task.md
  • agents/identify-scope.md
  • agents/design-phases.md
  • agents/generate-task-specs.md
  • agents/output-phase-files.md
  • agents/update-dependencies.md
  • agents/verify-specs.md
  • agents/update-system-specs.md
  • agents/generate-unassigned-task.md

Phase 12 と Phase 13 の境界

Phase 12 与 Phase 13 的边界

Task完了条件詳細
Task 12-1
implementation-guide.md
が Part 1/2 を満たす
references/phase-12-documentation-guide.md
Task 12-2Step 1 と Step 2 の判定が記録されるreferences/spec-update-workflow.md
Task 12-3
documentation-changelog.md
と artifacts が同期される
references/spec-update-validation-matrix.md
Task 12-40件でも
unassigned-task-detection.md
を出し、
current/baseline
を分離して記録する
references/unassigned-task-guidelines.md
Task 12-5改善点なしでも
skill-feedback-report.md
を出し、
phase12-task-spec-compliance-check.md
を root evidence として残す
references/patterns-phase12-sync.md
Phase 13commit と PR は user の明示承認後だけreferences/review-gate-criteria.md
UI/UX 実装を含む task では Phase 11 で screenshot と Apple UI/UX 視覚検証を行う。手順は references/phase-11-screenshot-guide.mdreferences/screenshot-verification-procedure.md を使う。
任务完成条件详细
任务12-1
implementation-guide.md
满足Part 1/2要求
references/phase-12-documentation-guide.md
任务12-2记录Step 1和Step 2的判定结果references/spec-update-workflow.md
任务12-3
documentation-changelog.md
与成果物同步
references/spec-update-validation-matrix.md
任务12-4即使0件也输出
unassigned-task-detection.md
,并分离记录
current/baseline
references/unassigned-task-guidelines.md
任务12-5即使无改进点也输出
skill-feedback-report.md
,保留
phase12-task-spec-compliance-check.md
作为核心证据
references/patterns-phase12-sync.md
Phase 13仅在获得用户明确批准后执行commit和PRreferences/review-gate-criteria.md
包含UI/UX实现的任务需在Phase 11中执行截图和Apple UI/UX视觉验证。步骤参考references/phase-11-screenshot-guide.mdreferences/screenshot-verification-procedure.md

リソース導線

资源导航

core workflow

核心工作流

  • references/resource-map.md
  • references/create-workflow.md
  • references/execute-workflow.md
  • references/commands.md
  • references/quality-standards.md
  • references/coverage-standards.md
  • references/review-gate-criteria.md
  • references/artifact-naming-conventions.md
  • references/evidence-sync-rules.md
  • references/self-improvement-cycle.md
  • references/resource-map.md
  • references/create-workflow.md
  • references/execute-workflow.md
  • references/commands.md
  • references/quality-standards.md
  • references/coverage-standards.md
  • references/review-gate-criteria.md
  • references/artifact-naming-conventions.md
  • references/evidence-sync-rules.md
  • references/self-improvement-cycle.md

phase templates

Phase模板

  • references/phase-templates.md
  • references/phase-template-core.md
  • references/phase-template-execution.md
  • references/phase-template-phase11.md
  • references/phase-template-phase12.md
  • references/phase-template-phase13.md
  • references/phase-templates.md
  • references/phase-template-core.md
  • references/phase-template-execution.md
  • references/phase-template-phase11.md
  • references/phase-template-phase12.md
  • references/phase-template-phase13.md

Phase 11/12 guides

Phase 11/12指南

  • references/phase-11-12-guide.md
  • references/phase-11-screenshot-guide.md
  • references/phase-12-documentation-guide.md
  • references/phase12-checklist-definition.md
  • references/technical-documentation-guide.md
  • references/screenshot-verification-procedure.md
  • assets/phase12-task-spec-compliance-template.md
  • references/phase-11-12-guide.md
  • references/phase-11-screenshot-guide.md
  • references/phase-12-documentation-guide.md
  • references/phase12-checklist-definition.md
  • references/technical-documentation-guide.md
  • references/screenshot-verification-procedure.md
  • assets/phase12-task-spec-compliance-template.md

spec update

规范更新

  • references/spec-update-workflow.md
  • references/spec-update-step1-completion.md
  • references/spec-update-step2-domain-sync.md
  • references/spec-update-validation-matrix.md
  • references/spec-update-workflow.md
  • references/spec-update-step1-completion.md
  • references/spec-update-step2-domain-sync.md
  • references/spec-update-validation-matrix.md

pattern family

模式集合

  • references/patterns.md
  • references/patterns-workflow-generation.md
  • references/patterns-validation-and-audit.md
  • references/patterns-phase12-sync.md
  • references/patterns.md
  • references/patterns-workflow-generation.md
  • references/patterns-validation-and-audit.md
  • references/patterns-phase12-sync.md

logs and archives

日志与归档

  • LOGS.md
  • references/logs-archive-index.md
  • references/logs-archive-2026-march.md
  • references/logs-archive-2026-feb.md
  • references/logs-archive-legacy.md
  • references/changelog-archive.md
  • LOGS.md
  • references/logs-archive-index.md
  • references/logs-archive-2026-march.md
  • references/logs-archive-2026-feb.md
  • references/logs-archive-legacy.md
  • references/changelog-archive.md

システム観点チェック

系统维度检查

観点aiworkflow-requirements 側の参照先
セキュリティ
security-*.md
UI/UX
ui-ux-*.md
アーキテクチャ
architecture-*.md
API/IPC
api-*.md
データ整合性
database-*.md
エラーハンドリング
error-handling.md
インターフェース
interfaces-*.md
Electron desktop task では Renderer、Main、IPC、Preload、ローカルストレージの境界を都度明記する。詳細は references/quality-standards.md を参照。
维度aiworkflow-requirements侧参考链接
安全性
security-*.md
UI/UX
ui-ux-*.md
架构
architecture-*.md
API/IPC
api-*.md
数据一致性
database-*.md
错误处理
error-handling.md
接口
interfaces-*.md
Electron桌面任务需明确标记Renderer、Main、IPC、Preload、本地存储的边界。详情参考references/quality-standards.md

検証コマンド

验证命令

bash
node scripts/validate-phase-output.js docs/30-workflows/{{FEATURE_NAME}}
node scripts/verify-all-specs.js --workflow docs/30-workflows/{{FEATURE_NAME}}
node ../skill-creator/scripts/quick_validate.js .claude/skills/task-specification-creator
node ../skill-creator/scripts/validate_all.js .claude/skills/task-specification-creator
diff -qr .claude/skills/task-specification-creator .agents/skills/task-specification-creator
node scripts/log-usage.js --result success --phase "Phase {{N}}"
Phase 12 では追加で
detect-unassigned-tasks.js
audit-unassigned-tasks.js
verify-unassigned-links.js
validate-phase12-implementation-guide.js
を実行する。
bash
node scripts/validate-phase-output.js docs/30-workflows/{{FEATURE_NAME}}
node scripts/verify-all-specs.js --workflow docs/30-workflows/{{FEATURE_NAME}}
node ../skill-creator/scripts/quick_validate.js .claude/skills/task-specification-creator
node ../skill-creator/scripts/validate_all.js .claude/skills/task-specification-creator
diff -qr .claude/skills/task-specification-creator .agents/skills/task-specification-creator
node scripts/log-usage.js --result success --phase "Phase {{N}}"
Phase 12需额外执行
detect-unassigned-tasks.js
audit-unassigned-tasks.js
verify-unassigned-links.js
validate-phase12-implementation-guide.js

ベストプラクティス

最佳实践

すべきこと

应该做的事

  • 仕様、テスト、実装、検証、同期の順序を崩さない。
  • outputs/phase-N/
    を phase ごとに実体化し、
    artifacts.json
    と同時更新する。
  • SubAgent 相当の lane は 3 並列以下に抑え、validation lane は直列で締める。
  • detail を増やしたくなったら
    references/
    へ逃がし、
    SKILL.md
    は入口に保つ。
  • Phase 12 は
    implementation-guide
    system-spec-update-summary
    documentation-changelog
    unassigned-task-detection
    skill-feedback-report
    を必ず揃える。
  • 遵循规范、测试、实现、验证、同步的顺序。
  • 为每个Phase实体化
    outputs/phase-N/
    目录,同步更新
    artifacts.json
  • SubAgent级别的流程线控制在3条并行以内,验证流程线采用串行收尾。
  • 如需增加细节,将内容移至
    references/
    ,保持
    SKILL.md
    作为入口的简洁性。
  • Phase 12务必集齐
    implementation-guide
    system-spec-update-summary
    documentation-changelog
    unassigned-task-detection
    skill-feedback-report

避けるべきこと

应该避免的事

  • .agents
    側だけ先に更新して canonical root を残すこと。
  • outputs/
    を後回しにして phase 完了だけ先に付けること。
  • current
    baseline
    の監査結果を混ぜること。
  • UI task で screenshot を自動テスト代替として扱うこと。
  • user の明示承認なしに commit や PR を作ること。
  • 仅更新
    .agents
    侧,保留正本未更新。
  • 推迟
    outputs/
    目录的处理,提前标记Phase完成。
  • 混淆
    current
    baseline
    的审计结果。
  • 在UI任务中将截图作为自动测试的替代方案。
  • 未获得用户明确批准即创建commit或PR。

変更履歴

变更历史

VersionDateChanges
v10.09.42026-03-15UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001 の Phase 12 再確認を反映:
references/spec-update-workflow.md
/
references/unassigned-task-guidelines.md
の運用に沿って、
SKILL.md
変更履歴更新(aiworkflow/task-spec 両方)を必須完了条件として明記。未タスクは
docs/30-workflows/unassigned-task/
の配置確認と
audit-unassigned-tasks --diff-from HEAD --target-file
の分離判定をセットで実施し、repo-wide テスト失敗を既存未タスクへ紐付ける判断基準を追補
v10.08.682026-03-15UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001 の system spec 詳細同期を完了
v10.08.672026-03-15UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001 再確認を反映:
runtime-routing-integration-closure
workflow の Phase 11/12 検証(TC 9/9・guide 10/10)と、
artifacts.json
/
index.md
/
phase-1..12
completed 同期を同一ターンで閉じる運用を追記。Step 2 は executor/electron-services/ui/state/task-workflow/lessons の同時同期を必須化
v10.08.672026-03-15UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001 の教訓・完了記録を同期:
lessons-learned-current.md
に P58(同名ファイル二重存在)判定手順、RuntimeResolver mock 戦略(P61派生)、vi.spyOn vs vi.mock セキュリティテスト判断基準の3苦戦箇所と5分解決カードを追加。LOGS.md 2ファイル + SKILL.md 2ファイルを同期
v10.08.662026-03-13TASK-UI-09-ONBOARDING-WIZARD の follow-up contract drift 対策を反映:
references/unassigned-task-guidelines.md
に、既存 follow-up 未タスクを流用する際は
2.2
/
3.1
/
3.5
/
6.検証方法
を current contract で再確認し、
audit-unassigned-tasks --diff-from HEAD --target-file
で個別監査するルールを追加。Phase 12 の 0 件報告と既存本文是正を両立させる運用を変更履歴へ追記
v10.08.652026-03-13TASK-UI-09-ONBOARDING-WIZARD の監査補修知見を反映:
references/phase-11-12-guide.md
に visual
TC-*
と non-visual check の ID 分離、および Phase 4 test-cases と Phase 10 checklist の pre-flight 突合ルールを追加。
references/spec-update-workflow.md
には
diff -qr
を伴う mirror sync 完了判定と
TC-ID
再利用禁止を追記し、Phase 11/12 の実行例・
verify-unassigned-links.js
既定参照先を
.claude
正本基準へ統一
v10.08.642026-03-13TASK-UI-09-ONBOARDING-WIZARD の完了同期を反映: onboarding wizard workflow 向けに
validate-phase12-implementation-guide
/
quick_validate
/
generate-index.js
/ dual-root mirror sync を同一ターンで閉じ、
outputs/verification-report.md
phase12-task-spec-compliance-check.md
へ実測値を書き戻す Phase 12 完了パターンを変更履歴へ追加
v10.08.632026-03-12TASK-SKILL-LIFECYCLE-04 の再監査知見を反映:
references/spec-update-workflow.md
に「既存 IPC 再利用でも public preload API 追加や shared barrel export 追加があれば Step 2 必須」とする判断ルールを追加。あわせて Phase 11 の
テストケース / 結果 / 証跡
literal、Phase 12 の必須見出し群(型定義 / APIシグネチャ / 使用例 / エラーハンドリング / エッジケース / 設定項目と定数一覧)を再確認ゲートへ固定
v10.08.622026-03-12UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001 の Phase 12 再確認を反映:
references/phase-11-12-guide.md
に docs-heavy task 向け same-day evidence review board fallback を追加し、
references/spec-update-workflow.md
に related unassigned row を completed 実績へ移した後の
verify-unassigned-links
exact count 再取得ルールを追記
v10.08.612026-03-12UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001 を反映: docs-only parent workflow 向けに
outputs/artifacts.json
同期、manual review の N/A screenshot 記録、
current=0 / baseline=134
の未タスク分離記法、parent/index/spec/script/mirror を一括で閉じる Phase 12 記録パターンを変更履歴へ追加
v10.08.602026-03-12TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 の未タスク formalize を反映:
UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001
docs/30-workflows/unassigned-task/
へ formalize し、親タスクの苦戦箇所を
3.5 実装課題と解決策
へ継承する運用を変更履歴へ追加。completed workflow の
unassigned-task-detection.md
/
documentation-changelog.md
/
spec-update-summary.md
を 1件 formalize 前提へそろえるルールも追記
v10.08.592026-03-12TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 の Phase 12 再確認を反映:
references/phase-11-12-guide.md
に loopback static serve fallback と
skill-creator
条件付き同期ルールを追加し、
references/spec-update-workflow.md
skill-creator/LOGS.md
/
skill-creator/SKILL.md
の条件付き更新を追記。global
unassigned-task/
監査値と 3 skill 同値転記を root evidence へ揃える運用を変更履歴へ追加
v10.08.582026-03-12TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001 を反映: guard workflow 向けに「current build static serve での harness build input 登録」「Phase 11 の Apple UI/UX 視覚レビュー」「
currentViolations=0
baselineViolations>0
を分離する discovered issue 記法」を変更履歴へ追加。Phase 12 では
.claude
正本更新と
.agents
drift 記録を分離する運用を明文化
v10.08.572026-03-11TASK-UI-04C follow-up の事後未タスク化を反映:
references/phase-11-12-guide.md
references/patterns.md
に、初回
新規未タスク 0件
で閉じた後でも親タスクの苦戦箇所が cross-cutting guard として再利用価値を持つ場合は、
unassigned-task-detection.md
/
spec-update-summary.md
/
documentation-changelog.md
を 0→1 へ再同期して正式な未タスク仕様書へ昇格する運用を追加
v10.08.562026-03-11TASK-UI-04C の再監査知見を反映:
references/phase12-checklist-definition.md
/
references/phase-11-12-guide.md
/
references/patterns.md
に、completed workflow の
phase-12-documentation.md
outputs/phase-12
から
仕様策定のみ
などの planned wording を除去するガードを追加し、実績同期と
[x]
更新を Phase 12 完了条件へ昇格
v10.08.552026-03-11TASK-UI-04C-WORKSPACE-PREVIEW の Phase 12 完了同期を反映: current workflow の
index.md
/
artifacts.json
/
phase-1..12
status /
outputs/verification-report.md
を completed 実績へ同期し、
validate-phase11-screenshot-coverage
/
validate-phase12-implementation-guide
/
verify-unassigned-links
/
audit-unassigned-tasks --diff-from HEAD
を Phase 12 完了ゲートとして明示した
v10.08.542026-03-11TASK-UI-04B-WORKSPACE-CHAT の Phase 12 再監査を反映:
implementation-guide.md
を validator 要件(Part 2 の TypeScript型 / APIシグネチャ / 使用例 / エラーハンドリング / エッジケース / 設定と定数)に適合させ、
phase-11-manual-test.md
に画面カバレッジマトリクスを追補。
validate-phase12-implementation-guide
validate-phase11-screenshot-coverage
warning解消を完了ゲートへ明記
v10.08.532026-03-11TASK-FIX-LIGHT-THEME-TOKEN-FOUNDATION-001 の completed workflow backlog 配置を反映: Phase 12 Task 4 の正本配置ルールを「active workflow 由来は
docs/30-workflows/unassigned-task/
、completed workflow 由来は
docs/30-workflows/completed-tasks/<workflow>/unassigned-task/
」へ明文化し、
audit-unassigned-tasks --json --diff-from HEAD --unassigned-dir <dir> --target-file <file>
を完了ゲートへ追加
v10.08.522026-03-11TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001 の再確認知見を反映:
references/unassigned-task-guidelines.md
に「指定ディレクトリ配置チェック(今回差分配置 / current判定 / legacy baseline)」の3行テンプレートを追加。
currentViolations=0
baselineViolations>0
を混同しない報告ルールを明文化し、Phase 12 再監査時の未タスク誤判定を防止
v10.08.512026-03-11TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001 の Phase 11/12 再監査を反映: Phase 11 で
capture-task-fix-apikey-chat-tool-integration-phase11.mjs
による TC-11-01..03 再撮影と Apple UI/UX 視覚検証を実施。Phase 12 では必須5成果物の不足を補完し、
phase-12-documentation.md
を Task 12-1〜12-5 構成へ是正。
artifacts.json
/
outputs/artifacts.json
同期、
validate-phase11-screenshot-coverage
/
validate-phase12-implementation-guide
を完了ゲートへ固定
v10.08.502026-03-11user 指定rootを正本にする Phase 12 ガードを追加:
references/phase12-checklist-definition.md
references/phase-11-12-guide.md
に、
.claude/skills/...
のような user 指定rootを canonical root として扱い、
.agents/skills/...
などの mirror root と drift がないことを完了条件に加えた
v10.08.492026-03-11TASK-UI-07 再監査で判明した canonical path drift を是正:
references/spec-update-workflow.md
を user 指定root基準へ補強し、Phase 12 完了時に canonical root / mirror root / drift 記録を同時に残す運用を変更履歴へ追加
v10.08.482026-03-11TASK-UI-08-NOTIFICATION-CENTER の Phase 11再監査追補を反映:
validate-phase11-screenshot-coverage
を完了ゲートへ含め、
phase-11-manual-test.md
テストケース
/
画面カバレッジマトリクス
manual-test-result.md
証跡
列を literal に保つ運用を変更履歴へ追加
v10.08.472026-03-11TASK-UI-08-NOTIFICATION-CENTER の Phase 12 完了同期を反映:
outputs/phase-12
5成果物と workflow root 文書(
index.md
/ traceability / diff reflection / verification-report)を同一ターンで同期し、spec-only stale を残さない運用を変更履歴へ追加
v10.08.482026-03-11TASK-SKILL-LIFECYCLE-01 の Phase 12 未タスク0件報告を強化:
references/unassigned-task-guidelines.md
currentViolations=0
かつ
baselineViolations>0
のときの推奨記述例を追加し、
今回差分
directory baseline
を分離するルールを明文化。
assets/phase12-task-spec-compliance-template.md
に legacy baseline と既存 remediation task の記録欄を追加し、0件報告でも backlog 導線を失わないテンプレートへ更新
v10.08.472026-03-11TASK-SKILL-LIFECYCLE-01 再監査知見を反映:
references/phase-11-12-guide.md
に representative screenshot は shell 全景より selector-based element capture を優先するルールを追加。
data-testid
または実文言を ready selector の正本とし、workflow
screenshot-plan.json
に selector を残す再利用パターンを明文化
v10.08.462026-03-10TASK-UI-06-HISTORY-SEARCH-VIEW の Phase 12再監査知見を反映:
references/spec-update-workflow.md
に「
.claude
が canonical root、
.agents
は mirror」ルールを追加し、
references/patterns.md
に Phase 12 の skill root 取り違えパターンを追加。workflow / outputs が
.agents/skills/.../references/
を正本として参照しないようにする再監査手順と、未タスク
UT-IMP-SKILL-ROOT-CANONICAL-SYNC-GUARD-001
の formalization を標準化
v10.08.452026-03-10TASK-UI-03 Phase 12再監査の backlog 整合を反映: current branch で解消済みの
UT-UI-03-TYPE-ASSERTION-001
を completed unassigned へ正規化し、Phase 11 light theme 所見を
UT-UI-03-LIGHT-SECONDARY-TEXT-CONTRAST-001
として task-spec フォーマットで formalize する運用を変更履歴へ追加。
unassigned-task-detection.md
/
task-workflow.md
/
spec-update-summary.md
の同値同期を標準化
v10.08.442026-03-10TASK-UI-03 再監査で task-specification-creator の canonical script path を是正:
.claude/skills/task-specification-creator/scripts/
を参照していた current workflow /
commands.md
/
phase-11-12-guide.md
/
phase-templates.md
/
patterns.md
/
unassigned-task-guidelines.md
.agents/skills/task-specification-creator/scripts/
へ統一し、
validate-phase-output.js
の位置引数契約へ再整合
v10.08.432026-03-10TASK-UI-03 current workflow 同期: Phase 11 の dedicated harness route と
manual-test-result.md
/
screenshot-plan.json
/
screenshot-coverage.md
の TC証跡構成を current workflow 実績へ反映し、Phase 12 で outputs/phase-4〜12 と
.claude/skills/...
正本を同ターン同期する運用を変更履歴へ追加
v10.08.422026-03-10TASK-10A-G完了: スキルライフサイクル統合テスト強化(G1:14件IPC契約 + G2:21件Store駆動 + G3:17件ChatPanel結線 = 52テスト全PASS)。arch-state-management.md関連タスクステータス更新、task-workflow.md完了タスク追加。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25対策)
v10.08.412026-03-10TASK-FIX-SAFEINVOKE-TIMEOUT-001 スキル改善: Phase 4 テンプレートに P13 タイマーテスト注意事項(advanceTimersByTime 必須、cleanup 検証、fake timers スコープ管理)を追加。Phase 5 テンプレートに P13 Pitfall 行と DRY 統合パターン(重複実装の共通ユーティリティ抽出手順)を追加。Phase 7 テンプレートに小規模ユーティリティ 100% カバレッジ達成パターンを追加。patterns.md に Preload IPC タイムアウトパターン2件(Promise.race タイムアウト、cleanup 検証テスト)を追加
v10.08.402026-03-10TASK-FIX-SAFEINVOKE-TIMEOUT-001 再監査運用を反映: Phase 12 で
PR マージ時に実施予定
を残さず、その場で
.claude/skills/...
正本・
SKILL.md
/
LOGS.md
・workflow outputs を同期するルールを追記。あわせて timeout タスクでは
cleanup
テストを acceptance に含め、明示 screenshot 要求時は非UIタスクでも影響 UI を representative capture する運用を固定
v10.08.392026-03-10TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001 再監査運用を反映: 明示 screenshot 要求時は P53 代替を使わず、専用 harness route +
screenshot-plan.json
+ capture metadata +
validate-phase11-screenshot-coverage
まで完了させる運用を追加。あわせて bypass view は reset 除外条件まで仕様化するルールと、worktree preflight
pnpm install --frozen-lockfile
を追記
v10.08.382026-03-09TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001 完了同期:
architecture-auth-security.md
に認証状態遷移 "timed-out" 追加・Settings bypass セキュリティ記録。
arch-state-management.md
に AUTH_TIMEOUT_MS タイムアウト機構記録。
ui-ux-navigation.md
に Settings の AuthGuard 外アクセス記録。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25対策)
v10.08.392026-03-10TASK-UI-04A-WORKSPACE-LAYOUT の worktree screenshot 運用を反映:
phase-11-12-guide.md
に「複数 worktree で preview source が揺れる場合は current build
out/renderer
を static 配信する」ルールを追加。current workflow の Phase 4-12 成果物補完、screenshot 8件再取得、
audit-unassigned-tasks --diff-from HEAD
current=0 確認までを再監査標準手順へ追記
v10.08.382026-03-09TASK-FIX-APP-DEBUG-LOCALSTORAGE-CLEAR-001 の screenshot ルールを追補:
phase-11-12-guide.md
に「persist bug では bug path 検証(通常ルート metadata)と screenshot path(dedicated harness)を分離し、
skipAuth=true
を唯一経路にしない」運用を追加。current workflow stale status / placeholder 除去と未タスク formalization の再監査手順も補強
v10.08.372026-03-09未タスク指示書の差分監査タイミングを明文化:
references/unassigned-task-guidelines.md
に「新規/全面更新した未タスク指示書は、作成直後に
audit-unassigned-tasks --json --diff-from HEAD --target-file <file>
を実行し、
currentViolations=0
まで閉じない」ルールを追加。配置済みとテンプレート準拠を分離して判定する運用へ補強
v10.08.362026-03-09TASK-FIX-CONCURRENCY-GUARD フィードバック反映: Phase 4 テスト仕様にモノレポテスト実行ディレクトリ注意書き(P40)を標準追加。Phase 2 設計テンプレートに「並行実行ガード検討」チェックポイントを追加
v10.08.352026-03-09TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001 再監査追補:
validate-phase-output
の誤 CLI 例(
--phase
)を template / guide / agent docs から除去し、
phase-11-12-guide.md
に「BrowserRouter 配下の harness で Router を二重にしない」ルールを追加。workflow12 の Phase 11 screenshot / Phase 12 実装ガイド再同期を前提にした運用へ補強
v10.08.342026-03-09TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001 完了同期:
arch-state-management.md
に executeSkill 並行実行ガードパターン追記。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25対策)。未タスク2件検出
v10.08.332026-03-08TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001 苦戦箇所追補: skill-creator によるテンプレート最適化 + 4仕様書への苦戦箇所記録
v10.08.322026-03-08TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001 仕様同期:
api-ipc-system.md
/
architecture-implementation-patterns.md
/
security-electron-ipc.md
/
task-workflow.md
に Graceful Degradation 完了記録を同期。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25対策)
v10.08.312026-03-08TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001 の Phase 12完了条件を補強:
references/phase-11-12-guide.md
phase-12-documentation.md
の Task 1-5 / Step 1-A〜3 / 完了条件チェックを実績同期する要件と、system spec 更新時に domain spec 側へ
実装内容 / 苦戦箇所 / 5分カード
または等価な lessons 参照を残す条件を追加。Phase 12 を成果物存在だけで閉じない運用へ補強
v10.08.302026-03-08workflow11 再確認運用を反映:
references/phase-11-12-guide.md
に「App shell 遷移が不安定な場合は同一 view を直描画する harness route を優先してよい」を追記。workflow11 で
TC-11-UI-01..03
screenshot,
テストケース
,
画面カバレッジマトリクス
, follow-up issue 登録までを一連運用として固定
v10.08.292026-03-08TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001 完了同期:
api-ipc-auth.md
に Profile/Avatar fallback ハンドラ完了タスクセクション追加。
error-handling.md
に変更履歴追加。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25対策)
v10.08.282026-03-08TASK-10A-F Phase 12タスク仕様再確認の運用を追補:
references/phase-11-12-guide.md
に comparison baseline の completed workflow も
verify-all-specs --strict
/
validate-phase-output
PASS まで揃えてから branch 判定する手順を追加。
references/unassigned-task-guidelines.md
には
currentViolations=0
baselineViolations>0
の二層報告ルールと、「指定ディレクトリに配置済み」と「directory 全体健全化」を分離して記録する運用を追加
v10.08.272026-03-08TASK-10A-F final sync を反映: current workflow の Phase 11/12 同期だけでなく、comparison baseline の completed workflow も
verify-all-specs --strict
/
validate-phase-output
PASS まで同ターンで正規化する運用を変更履歴へ反映。加えて
capture-skill-analysis-view-screenshots.mjs
data-testid
ready selector 化、
capture-skill-create-wizard-screenshots.mjs
の Store由来フォールバック文言待機、
phase-12-documentation.md
Step 1-D の
generate-index.js
パス修正を再監査標準手順へ昇格
v10.08.262026-03-08TASK-10A-F current workflow 再監査の運用穴を反映:
SKILL.md
evidence-sync-rules.md
/
screenshot-verification-procedure.md
/
phase12-checklist-definition.md
の直リンクを実体として追加し、
quick_validate
warning 3件を解消。あわせて Phase 12 集約監査(Task 12-1〜12-5 + Step 1-A〜1-G / Step 2)と
spec_created
workflow の Phase 11/12 artifacts 同期方針を変更履歴へ反映
v10.08.252026-03-08TASK-10A-E-D/TASK-UI-03/TASK-10A-F 仕様同期: 5教訓・5パターン・5完了タスク・5未タスクを6並列SubAgentで仕様書正本へ同期。lessons-learned/arch-state-management/task-workflow/patterns/LOGS/SKILLを同時更新。P1/P25対策で4ファイル同時更新
v10.08.242026-03-07TASK-10A-F 再確認を反映: ユーザー要求に基づく画面検証を
SCREENSHOT
必須運用で再実行し、
store-driven-lifecycle-ui
の Phase 11 証跡を11件へ更新。Phase 12 の不足成果物(
unassigned-task-detection.md
/
skill-feedback-report.md
/
spec-update-summary.md
)を補完し、Step 1-A〜Step 2 実更新を同ターンで完了する運用を追記
v10.08.242026-03-08branch横断 Phase 12 再監査 + persist iterable hardening 仕様同期を完了:
arch-state-management.md
に persist 復旧契約(DD-01〜DD-03)追記、
lessons-learned.md
にコード例と関連Pitfall参照追加、
task-workflow.md
に完了タスクと5分解決カード追記、
skill-creator/references/patterns.md
に persist 3段ガード + branch横断監査パターン追加。4仕様書を5並列SubAgentで同時更新
v10.08.232026-03-07TASK-10A-E-C の実装知見をシステム仕様へ資産化:
architecture-implementation-patterns.md
S18追加、
lessons-learned.md
苦戦箇所3件追記、
06-known-pitfalls.md
P48追加。431テスト全PASS、Phase 1-12完了の実装結果を4ファイル(LOGS.md x2 + SKILL.md x2)に反映
v10.08.222026-03-06TASK-10A-E-C の Phase 12再確認テンプレート適合を反映:
phase-12-documentation.md
の完了チェック同期、
documentation-changelog.md
の実更新化、未タスク2件の9見出しテンプレート準拠化を再監査手順として追記。
validate-phase11-screenshot-coverage
audit --target-file
をセットで回す運用を標準化
v10.08.212026-03-06TASK-10A-E-C の Phase 11/12運用を反映:
manual-test-result.md
TC-ID + 証跡
形式へ更新し、
validate-phase11-screenshot-coverage
が expected=8/covered=8 で通る証跡設計を追加。
spec-update-summary.md
の「更新予定のみ」記述を実更新結果へ置換し、未タスク2件の3ステップ登録(指示書作成/台帳同期/関連仕様参照)を標準手順に反映
v10.08.202026-03-06TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001 再監査の運用穴をガイドへ反映:
references/phase-11-12-guide.md
に専用 harness を用いた Phase 11 再撮影条件、
phase11-capture-metadata.json
manual-test-result.md
の同期、
画面カバレッジマトリクス
テストケース
列必須化を追記。
references/spec-update-workflow.md
には IPC transport 契約変更時に
references/ipc-contract-checklist.md
/
indexes/quick-reference.md
まで確認する cross-cutting doc 更新ルールを追加
v10.08.192026-03-06TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001 Phase 1-12 実行を反映:
docs/30-workflows/completed-tasks/03-TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001
の Phase 1〜12 を実行し、Phase 11 は
TC-11-01..05
のスクリーンショット5件と Apple UI/UXレビューを必須証跡として固定。Phase 12 は 6成果物生成、
complete-phase.js
による台帳同期、
artifacts.json
/
outputs/artifacts.json
整合、
phase-1..12*.md
completed 同期、
verify-unassigned-links
broken link 修復、
verify-all-specs
/
validate-phase-output
/
validate-phase11-screenshot-coverage
再実行を標準運用として記録
v10.08.182026-03-06Phase 12準拠チェックと親仕様参照ガードを追加:
assets/phase12-task-spec-compliance-template.md
を新設し、Task 12-1〜12-5 / Step 1-A〜1-G / Step 2 の判定を1ファイルへ集約するテンプレートを追加。あわせて
scripts/verify-all-specs.js
task-*.md
/
../task-*.md
の参照実在も検証対象に拡張し、親仕様ブリッジ欠落を自動検出できるよう更新
v10.08.172026-03-06TASK-043B 再監査の導線修復ルールを反映:
references/phase-11-12-guide.md
TC-xx
本体証跡と
VIS-xx
補助証跡の分離運用を追加し、
references/spec-update-workflow.md
../task-xxx.md
親仕様参照のブリッジ確認チェックを追記。Phase 12で workflow ディレクトリと親仕様ファイルの両方を実在確認する手順を明文化
v10.08.162026-03-06TASK-043B の Phase 11/12 実行知見を反映:
manual-test-result.md
TC-ID + 証跡 + 非視覚ログ
形式、補助 screenshot warning の扱い、
validate-phase11-screenshot-coverage
を 9 TC ベースで通す運用を LOGS と合わせて追記
v10.08.212026-03-07TASK-UI-03 Phase 4 a11y テスト推奨を追加:
references/phase-templates.md
の Phase 4 テンプレートにアクセシビリティテスト(WCAG 2.1 AA)推奨セクションを追加。ARIA ラベル / ロール属性 / キーボード操作 / コントラスト比 / 状態通知の5観点を UIタスクの Phase 4 で早期テスト設計するよう標準化。根拠: TASK-UI-03 で Phase 10 まで a11y 属性不足が検出されず4件の未タスク化が発生した教訓
v10.08.202026-03-07TASK-UI-03 スキルフィードバック改善を反映: Phase 2テンプレートにUIタスク向け「z-index管理テーブル」セクションを追加(条件付き)。Phase 12テンプレート Step 1-Cに関連タスク検索コマンド例を追加し、自動化ヒントを強化
v10.08.192026-03-07TASK-UI-03-AGENT-VIEW-ENHANCEMENT Phase 12 完了を反映: AIアシスタント画面リデザイン(Tap & Discover)の実装ガイド・コンポーネントドキュメント・未タスク4件・スキルフィードバックレポートを作成。LOGS.md 2ファイル + SKILL.md 2ファイル同時更新(P1/P25/P29対策)
v10.08.182026-03-06TASK-UI-02 再々監査の workflow 本文 stale 是正を反映:
references/phase-11-12-guide.md
references/spec-update-workflow.md
に「
artifacts.json
/
index.md
が completed でも
phase-1..11
本文仕様書へ
pending
が残っていないことを確認する」チェックを追加。Phase 12 完了判定を「成果物 / 台帳 / 本文仕様書」の三層同期へ拡張
v10.08.172026-03-06TASK-UI-02 Phase 12 再整合手順を追補:
references/phase-11-12-guide.md
references/spec-update-workflow.md
outputs/artifacts.json
同期後の
generate-index.js --workflow ... --regenerate
index.md
状態確認を追加し、artifacts 完了済みでも workflow index が stale なまま残る再発を防止
v10.08.162026-03-06TASK-UI-02 再監査の運用知見を反映:
SKILL.md
screenshot-verification-procedure.md
/
phase12-checklist-definition.md
/
evidence-sync-rules.md
の直リンクを追加し、Phase 11/12 の導線不足を解消。あわせてコマンド例を canonical path へ統一し、変更履歴の version 重複を防ぐ採番確認ルールを明文化
v10.08.172026-03-06Phase 12 実装ガイド内容 validator を追加:
validate-phase12-implementation-guide.js
とテストを追加し、Task 12-1 の理由先行 / 日常例え / TypeScript型 / API・CLI シグネチャ / 使用例 / エラー処理 / 設定一覧を機械検証できるようにした。あわせて
evidence-sync-rules.md
/
phase12-checklist-definition.md
/
screenshot-verification-procedure.md
を SKILL 導線へ接続
v10.08.162026-03-06UT-TASK-10A-B-008 再監査の教訓を反映:
references/phase-11-12-guide.md
に「ユーザーが明示的にスクリーンショット検証を要求した場合は
NON_VISUAL
単独不可」「ready 判定は root ではなく loaded-state selector を使う」「light 証跡は theme mock を撮影シナリオへ追従させる」を追加。Phase 12 の漏れパターンにも同条件を追記
| v10.08.15 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 再確認で判明した Phase 12台帳ドリフト対策を反映:
references/phase-11-12-guide.md
の Task 3.5 と完了チェックへ「
phase-12-documentation.md
ステータス=completed
とチェックリスト同期の両方が必須」を追記。成果物実体のみで完了判定しない運用を明文化 | | v10.08.14 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 再監査を反映: ユーザー追加要求に基づく Phase 11 画面回帰撮影(3スクリーンショット)を workflow 直下へ再証跡化し、
manual-test-result.md
TC + 証跡
形式へ更新。併せて仕様書のDIシグネチャ旧表記を現行実装へ同期し、
validate-phase11-screenshot-coverage
を再実行する運用を追記 | | v10.08.13 | 2026-03-05 | TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001 実行を反映:
docs/30-workflows/02-TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001
の Phase 1〜12 を完了。Task 12 Step 1-A/1-B/1-C として
interfaces-agent-sdk-executor.md
/
api-ipc-system.md
の完了タスク・実装状況・関連タスクを同期し、
verify-all-specs
/
validate-phase-output
/
complete-phase
をフェーズ単位で実行する運用を記録 | | v10.08.12 | 2026-03-05 | TASK-UI-01-C 再監査(phase/index整合 + Phase 11 実画面証跡)を反映:
artifacts.json
が completed でも
index.md
/
phase-1..10
に pending が残るドリフトを是正する運用を追加。
apps/desktop/scripts/capture-task-056c-notification-history-screenshots.mjs
TC-11-01..03
を再取得し、
manual-test-result
/
evidence-index
/
screenshot-matrix
SCREENSHOT + NON_VISUAL
併用形式へ更新する再監査手順を固定 | | v10.08.12 | 2026-03-05 | TASK-FIX-AUTH-KEY-HANDLER-REGISTRATION-001 再監査の Phase 11 TCカバレッジ是正を反映:
phase-11-manual-test.md
テストケース
/
画面カバレッジマトリクス
必須化を運用適用し、
manual-test-result.md
TC + 証跡
形式へ是正。
validate-phase11-screenshot-coverage
(3/3)PASS を Phase 12成果物へ同期し、
quick_validate
warning分類(要監視/要対応)記録を追加 | | v10.08.11 | 2026-03-05 | 未タスク監査の
--target-file
適用境界を明文化
:
references/unassigned-task-guidelines.md
に「
--target-file
docs/30-workflows/unassigned-task/
配下のみ指定可能」「
outputs/phase-12/*.md
監査は
--diff-from HEAD
を使う」を追記し、Phase 12 再監査時のコマンド誤用を予防 | | v10.08.10 | 2026-03-05 | Phase 11 TC-ID検証の明確化を反映:
references/phase-11-12-guide.md
に「
MT-xx
などシナリオIDのみは coverage validator 対象外」「
TC-xx
併記必須」を追記し、
rg
で事前にTC抽出可否を確認する手順を追加。
validate-phase11-screenshot-coverage
の取りこぼし(expected TC=0)を事前に防止 | | v10.08.9 | 2026-03-05 | UT-TASK-10A-B-001 最終再監査(未タスク配置是正)を反映: Phase 12の未タスク監査を最新値(
verify-unassigned-links
102/102、
audit --json
current=90、
audit --diff-from HEAD
current=0 baseline=90)へ更新。完了済み指示書(001)は
completed-tasks
直下、未実施指示書(002〜008)は
unassigned-task
へ分離配置する運用を追補し、スクリーンショット5件を 11:00 JST に再取得した視覚検証ログと成果物3点(
spec-update-summary
/
documentation-changelog
/
unassigned-task-detection
)を同期 | | v10.08.8 | 2026-03-05 | UT-TASK-10A-B-001 再監査追補を反映: Phase 11 の light/dark 証跡整合チェックを強化し、
capture-ut-task-10a-b-001-screenshots.mjs
のテーマモックを
prefers-color-scheme
連動へ修正。
documentation-changelog.md
/
unassigned-task-detection.md
--target-file
監査と screenshot coverage(5/5)を追記する運用を追加 | | v10.08.7 | 2026-03-05 | UT-TASK-10A-B-001 Phase 1-12 実行を反映: UI追加タスクの実行実績(Red→Green、53テストPASS、対象カバレッジ 100/96.22/100、Phase 11 スクリーンショット5件)を運用記録へ追加。
outputs/phase-1
phase-12
成果物生成と
artifacts.json
同期、Step 1-A〜1-G 実行ログ反映を標準手順に再適用 | | v10.08.6 | 2026-03-04 | Phase 11証跡の workflow 配置ドリフト対策をガイドへ追加:
references/phase-11-12-guide.md
に「証跡は対象workflow配下
outputs/phase-11/screenshots
を必須」「非視覚TCは
NON_VISUAL:
記法を必須」を追記。Phase 12チェックリストへ同条件を追加し、
validate-phase11-screenshot-coverage
失敗(別workflow参照のみ)を再発防止 | | v10.08.5 | 2026-03-04 | UI再撮影の Port 5174 競合ガードを Phase 11/12 ガイドへ追加:
references/phase-11-12-guide.md
の preview preflight に
lsof -nP -iTCP:5174 -sTCP:LISTEN
を追加し、
Port 5174 is already in use
発生時の分岐(停止/再利用)を
spec-update-summary.md
へ記録する完了条件を明文化。自動化コマンドとチェックリストにも同要件を同期 | | v10.08.4 | 2026-03-04 | Phase 12 Step 1-C(関連タスク表の完了同期)を再確認運用へ追加:
UT-IMP-PHASE12-SCREENSHOT-COMMAND-REGISTRATION-GUARD-001
を対象に、
ui-ux-feature-components.md
の関連未タスク表、未タスク指示書、issue の3点ステータスを同一ターンで完了化する是正例を記録。完了状態の条件として「status更新 + チェックリスト同期 + 完了注記」を明文化 | | v10.08.3 | 2026-03-04 | TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001 第2回再確認を反映:
outputs/phase-11
の画面証跡時刻を 16:50 JST に更新し、撮影コマンドを
capture-skill-center-metadata-guard-screenshots.mjs
へ統一。
spec-update-summary.md
/
unassigned-task-detection.md
/
documentation-changelog.md
の再監査値を
verify-unassigned-links
88/88、
audit --diff-from HEAD
baseline=94 へ同期し、
phase-12-documentation.md
の引き継ぎ事項を完了移管済みへ更新 | | v10.08.2 | 2026-03-04 | SkillCenter再監査の UI再撮影 preflight を標準化:
references/phase-11-12-guide.md
に再撮影前
preview preflight
(build成功 +
127.0.0.1:4173
疎通確認)を追加。失敗時は
unassigned-task-detection.md
へ記録し、
docs/30-workflows/unassigned-task/
へ未タスク化する分岐を完了条件チェックへ追記 | | v10.08.1 | 2026-03-04 | TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001 再監査の最終固定:
complete-phase.js
を Phase 1〜12 へ順次適用して
artifacts.json
completed
同期、
outputs/artifacts.json
を生成。
generate-index
(2スキル)+
verify-all-specs
(13/13)+
validate-phase-output
(28項目)+
validate-phase11-screenshot-coverage
(4/4)+
verify-unassigned-links
(88/88)を再実行し、再監査の証跡を固定 | | v10.08.0 | 2026-03-04 | TASK-FIX-SKILL-IMPORT 3連続是正の再監査を反映:
01/02/03
workflow を再監査し、
aiworkflow-requirements
正本6仕様書(api-ipc/interfaces/arch-state/ui-ux-feature/task-workflow/lessons)へ実装内容と苦戦箇所を同期。Phase 12 Task 5 必須の4ファイル(
LOGS.md
x2 +
SKILL.md
x2)を同一ターンで更新し、
verify-all-specs
(3workflow)/
validate-phase-output
(3workflow)/
validate-phase11-screenshot-coverage
(workflow03)/
audit --diff-from HEAD
の証跡を固定 | | v10.07.1 | 2026-03-03 | TASK-10A-D 再監査追補: Phase 11 証跡不足を是正し、
outputs/phase-11/screenshots/
に TC-01〜TC-05 を追加。
manual-test-result.md
を証跡列付きへ更新して
validate-phase11-screenshot-coverage
を PASS 化。
task-workflow.md
の未タスクリンク3件を修正し、
verify-unassigned-links
ALL_LINKS_EXIST
へ回復。
artifacts.json
index.md
を再同期して Phase 13 を
pending
(未実施)へ整合化 | | v10.07.0 | 2026-03-03 | TASK-10A-D Phase 12 完了同期:
ui-ux-components.md
/
ui-ux-feature-components.md
/
arch-ui-components.md
/
arch-state-management.md
/
interfaces-agent-sdk-skill.md
/
task-workflow.md
に実装内容と苦戦箇所3件(Suggestion型不整合、P40再発、P11パターン)を同期。LOGS.md 2ファイル・SKILL.md 2ファイル同時更新(P1/P25/P29対策)。P43準拠3ファイル以下/エージェントに分割実行 | | v10.06.0 | 2026-03-02 | TASK-10A-C 再監査パターンを反映:
phase-11-manual-test.md
/
phase-12-documentation.md
で依存Phase成果物(2/5/6/7/8/9/10)の参照資料補完を必須化し、
verify-all-specs
の依存参照warningをゼロ化する運用を追記。UIタスクでは
screenshot:*
再実行で証跡鮮度を固定し、Step 1-A の LOGS/SKILL 4点同時更新を完了条件として明文化 | | v10.05.0 | 2026-03-02 | Phase 13 PR本文セクション連携を強化:
phase-templates.md
の Phase 13 に
/ai:diff-to-pr
Phase 3.6(
TARGET_WORKFLOW_DIR
特定)との連携ルールを追加し、PR本文を
.github/pull_request_template.md
準拠セクションへ同期。UI/UX変更時は
outputs/phase-11/screenshots/*.png
をPR本文
## スクリーンショット
へ自動挿入する要件を追加。
phase-11-12-guide.md
完了チェックへ「Phase 13で対象workflow確認」「
## その他
へのPhase 12実装ガイド反映」確認項目を追加 | | v10.04.0 | 2026-03-02 | Phase 11 画面カバレッジマトリクス改善:
phase-templates.md
に画面カバレッジマトリクス(4ステップ: 変更コンポーネント洗い出し/UI状態カバレッジ定義/撮影計画JSON作成/カバレッジレポート)を追加。
phase-11-12-guide.md
の実行フローを9ステップに拡張し、撮影コマンドをA.計画ベース一括撮影/B.個別撮影の2構成に再編。
capture-screenshots.js
を拡張版に更新(--plan/--selector/--action/--action-target/--helpオプション追加、テーマ別グループ化、カバレッジレポート自動生成) | | v10.05.0 | 2026-03-02 | TASK-10A-B Phase 11/12 再監査を反映:
phase-11-manual-test.md
に必須セクション「統合テスト連携」を追加し、
manual-test-result.md
を実スクリーンショット証跡ベースへ更新。
unassigned-task-detection.md
を 7件→5件へ再同期。
verify-all-specs
warning 13→0、
validate-phase-output
を 28項目PASS へ復帰 | | v10.04.0 | 2026-03-02 | TASK-10A-B SkillAnalysisView 実装完了を反映: Phase 1-12全完了(72テスト全PASS、カバレッジ Line100%/Branch95.83%/Function100%)。LOGS.md 2ファイル・SKILL.md 2ファイルを同時更新し、topic-map.md を再生成。
docs/30-workflows/completed-tasks/skill-analysis-view/outputs/phase-12/spec-update-summary.md
を更新 | | v10.03.0 | 2026-03-02 | Phase 12準拠再確認の実行パターンを反映:
skill-editor-view
TASK-UI-05
の2workflowで
verify-all-specs
/
validate-phase-output
を同時実行し、Task 1/3/4/5成果物実体・implementation-guide Part 1/2・未タスク10見出しを同一ターンで突合する運用を確立。未タスク監査は
currentViolations=0
を合格基準に固定 | | v10.02.0 | 2026-03-02 | TASK-UI-05A 再監査(Phase 11/12整合是正):
outputs/phase-11
へ 2026-03-02 再取得スクリーンショット(Dashboard/Editor/導線チェック)を追補。
outputs/phase-12/spec-update-summary.md
を追加し、未タスク正本3件(
docs/30-workflows/unassigned-task/
)と
artifacts.json
/
outputs/artifacts.json
の同期を反映 | | v10.01.0 | 2026-03-01 | TASK-UI-05A 包括的監査・仕様修正反映: Phase 1/2/4/5 に skill:getFileTree IPCチャネルを追加し、useFileTree 引数仕様を skillName ベースに統一。UT-UI-05A-GETFILETREE-001 未タスク登録を反映 | | v10.00.0 | 2026-03-01 | TASK-UI-05A spec_created 再監査を反映: Phase 12運用に「画面検証スクリーンショット必須」を明記し、
docs/30-workflows/skill-editor-view/outputs/phase-11/
への証跡(Dashboard/Editorスクリーンショット、manual-test-result、discovered-issues)同期手順を追補。併せて
verify-unassigned-links
失敗要因になっていた completed-tasks 移管後リンクドリフトの是正運用を反映 | | v10.02.0 | 2026-03-02 | TASK-UI-05B 実装完了再監査を反映:
docs/30-workflows/skill-advanced-views
を再監査し、
spec_created
残存を
completed
へ同期。Phase 11 画面証跡(TC-04〜TC-07)を追加。
phase-12-documentation.md
をテンプレート準拠(
実行タスク
/
参照資料
/
成果物
/
完了条件
)へ補正し、
verify-all-specs
(13/13)/
validate-phase-output
(28項目)を PASS に復帰。Phase 12 Step 1-A の
SKILL.md
/
LOGS.md
4点同期を完了 | | v10.01.0-v9.97.0 | 2026-03-01〜2026-02-28 | Phase 12 完了同期と再監査ルールの整備:
artifacts.json
/
outputs/artifacts.json
/
index.md
/
phase-1..12
の同期、必須成果物実体確認、
validate-phase-output
/
verify-all-specs
/
verify-unassigned-links
/ screenshot coverage の完了ゲート化を段階的に整理。詳細は
LOGS.md
を参照 | | v9.96.0-v9.92.2 | 2026-02-27〜2026-02-25 | Phase 12 guard と quick_validate 運用の標準化: unassigned audit、親仕様参照整合、completed-tasks 移管、
quick_validate.js
経路統一、skill-creator 連携、
## メタ情報
重複防止などの再発防止ルールを整備。詳細は
LOGS.md
を参照 | | v9.92.1 | 2026-02-25 | 履歴運用改善:
SKILL.md
の変更履歴を直近中心に整理し、構造検証(500行上限)に適合。詳細な長期履歴は
LOGS.md
を正本として参照する方針へ統一 | | v9.92.0 | 2026-02-25 | UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001 再監査同期:
references/spec-update-workflow.md
の baseline/current 判定手順を
--target-file
/
--diff-from
ベースへ更新 | | v9.91.0 | 2026-02-25 | UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001 実装反映:
scripts/audit-unassigned-tasks.js
--target-file
/
--diff-from
currentViolations
/
baselineViolations
分離、scoped 判定を追加 | | v9.90.0 | 2026-02-25 | UT-IPC-AUTH-HANDLE-DUPLICATE-001 再確認反映:
phase-11-12-guide.md
/
spec-update-workflow.md
にスキル構造検証チェックを追記(
quick_validate.js
ベース) |
補足: v9.89.0 以前の履歴は
LOGS.md
に保持(監査証跡を維持)。 | v10.09.3 | 2026-03-13 | Phase 12 root evidence と split-aware 未タスク監査を強化:
assets/phase12-task-spec-compliance-template.md
を 4点突合 / implementation-guide 必須要素 / current-baseline 分離 / system spec 同期まで確認する root evidence 形式へ拡張し、
scripts/verify-unassigned-links.js
は親
task-workflow.md
指定時に sibling
task-workflow*.md
も走査するよう改善した。
references/unassigned-task-guidelines.md
にも split-aware 実行前提を追記 | | v10.09.2 | 2026-03-13 | artifacts schema compatibility を修正:
schemas/artifact-definition.json
を current workflow 実体へ合わせ、legacy string artifact array、Phase
blocked
metadata.taskType=improvement
を validator 互換として受理するよう更新。
references/artifact-naming-conventions.md
に object 推奨 / legacy 互換の運用ルールも追記した | | v10.09.1 | 2026-03-13 | TASK-IMP-AIWORKFLOW-REQUIREMENTS-LINE-BUDGET-REFORM-001 の再監査知見を反映:
spec_created
workflow でも branch-level documentation drift を解消するために
outputs/phase-12/
の shell を補完してよいが、
artifacts.json
currentPhase
は execution progress の正本として維持し、implementation guide / documentation changelog / cross-skill feedback を Phase 12 checklist の細目まで満たすルールを固定した | | v10.09.0 | 2026-03-12 | TASK-IMP-TASK-SPECIFICATION-CREATOR-LINE-BUDGET-REFORM-001 を反映:
SKILL.md
を入口特化へ slim 化し、
patterns
phase-templates
spec-update-workflow
phase-11-12-guide
LOGS.md
を family file と archive へ再編した。canonical root は
.claude
、mirror は
.agents
に固定し、line budget / direct link / mirror parity / dependency integrity の検証導線を整理した | | v10.08.60 | 2026-03-12 |
UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001
formalize を反映 | | v10.08.59 | 2026-03-12 | current build static serve fallback と skill-creator 条件付き同期ルールを追加 | | v10.08.58 | 2026-03-12 | Apple UI/UX 視覚レビューと current/baseline 分離記法を追記 | | v10.08.57 | 2026-03-11 | 事後未タスク化による 0件→1件 再同期ルールを追加 |
詳細な履歴と usage log は LOGS.mdreferences/logs-archive-index.md を参照。
版本日期变更内容
v10.09.42026-03-15反映UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001的Phase 12重新确认: 按照
references/spec-update-workflow.md
/
references/unassigned-task-guidelines.md
的操作流程,明确将SKILL.md变更历史更新(aiworkflow/task-spec两者)作为必选完成条件。未分配任务需同时执行
docs/30-workflows/unassigned-task/
的位置确认和
audit-unassigned-tasks --diff-from HEAD --target-file
的分离判定,补充将仓库级测试失败关联至现有未分配任务的判断标准
v10.08.682026-03-15完成UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001的系统规范细节同步
v10.08.672026-03-15反映UT-IMP-SKILL-AGENT-RUNTIME-ROUTING-INTEGRATION-CLOSURE-001的重新确认: 补充
runtime-routing-integration-closure
工作流的Phase 11/12验证(TC 9/9・指南10/10)和
artifacts.json
/
index.md
/
phase-1..12
completed状态同步需在同一周期内完成的操作流程。Step 2必须同步executor/electron-services/ui/state/task-workflow/lessons
v10.08.672026-03-15同步UT-CHAT-EDIT-WORKSPACE-CONSTRAINT-TEST-001的经验教训・完成记录: 在
lessons-learned-current.md
中添加P58(同名文件重复存在)判定步骤、RuntimeResolver模拟策略(衍生自P61)、vi.spyOn vs vi.mock安全测试判断标准这3个难点和5个解决方案卡片。同步2份LOGS.md + 2份SKILL.md
v10.08.662026-03-13反映TASK-UI-09-ONBOARDING-WIZARD的后续契约偏移应对措施: 在
references/unassigned-task-guidelines.md
中添加,复用现有后续未分配任务时需通过
2.2
/
3.1
/
3.5
/
6.验证方法
重新确认当前契约,并通过
audit-unassigned-tasks --diff-from HEAD --target-file
进行单独审计的规则。在变更历史中补充Phase 12同时实现0件报告和修正现有内容的操作流程
v10.08.652026-03-13反映TASK-UI-09-ONBOARDING-WIZARD的审计修复经验: 在
references/phase-11-12-guide.md
中添加视觉
TC-*
和非视觉检查的ID分离规则,以及Phase 4测试用例与Phase 10检查表的预检查核对规则。在
references/spec-update-workflow.md
中补充伴随
diff -qr
的镜像同步完成判定和禁止复用
TC-ID
的规则,将Phase 11/12的执行示例・
verify-unassigned-links.js
默认参考源统一为
.claude
正本标准
v10.08.642026-03-13反映TASK-UI-09-ONBOARDING-WIZARD的完成同步: 为onboarding wizard工作流补充
validate-phase12-implementation-guide
/
quick_validate
/
generate-index.js
/ 双正本镜像同步需在同一周期内完成的操作流程,将实测值写入
outputs/verification-report.md
phase12-task-spec-compliance-check.md
的Phase 12完成模式添加至变更历史
v10.08.632026-03-12反映TASK-SKILL-LIFECYCLE-04的重新审计经验: 在
references/spec-update-workflow.md
中添加「即使复用现有IPC,若添加了公共preload API或共享桶导出,也必须执行Step 2」的判断规则。同时将Phase 11的
测试用例 / 结果 / 证据
字面量、Phase 12的必选标题组(类型定义 / API签名 / 使用示例 / 错误处理 / 边缘场景 / 配置项与常量列表)固定至重新确认门控
v10.08.622026-03-12反映UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001的Phase 12重新确认: 在
references/phase-11-12-guide.md
中添加面向文档密集型任务的当日证据评审委员会备选方案,在
references/spec-update-workflow.md
中添加将关联未分配任务行移至已完成记录后,通过
verify-unassigned-links
重新获取精确计数的规则
v10.08.612026-03-12反映UT-IMP-WORKSPACE-PARENT-REFERENCE-SWEEP-GUARD-001: 为仅包含文档的父工作流补充
outputs/artifacts.json
同步、手动评审的N/A截图记录、
current=0 / baseline=134
的未分配任务分离记法、将parent/index/spec/script/mirror一次性收尾的Phase 12记录模式添加至变更历史
v10.08.602026-03-12反映TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001的未分配任务规范化: 将
UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001
规范化至
docs/30-workflows/unassigned-task/
,补充将父任务难点继承至
3.5 实现问题与解决方案
的操作流程。同时补充已完成工作流的
unassigned-task-detection.md
/
documentation-changelog.md
/
spec-update-summary.md
需基于1件规范化前提对齐的规则
v10.08.592026-03-12反映TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001的Phase 12重新确认: 在
references/phase-11-12-guide.md
中添加环回静态服务备选方案和
skill-creator
条件式同步规则,在
references/spec-update-workflow.md
中补充
skill-creator/LOGS.md
/
skill-creator/SKILL.md
的条件式更新。补充将全局
unassigned-task/
审计值和3个技能的等值转录作为核心证据的操作流程至变更历史
v10.08.582026-03-12反映TASK-IMP-LIGHT-THEME-CONTRAST-REGRESSION-GUARD-001: 为防护工作流补充「当前构建静态服务的测试 harness 构建输入注册」「Phase 11的Apple UI/UX视觉评审」「
currentViolations=0
baselineViolations>0
分离的问题发现记法」至变更历史。明确Phase 12中
.claude
正本更新与
.agents
偏移记录分离的操作流程
v10.08.572026-03-11反映TASK-UI-04C后续的事后未分配任务化: 在
references/phase-11-12-guide.md
references/patterns.md
中添加,即使首次以「新未分配任务0件」收尾,若父任务难点具有跨领域防护复用价值,需将
unassigned-task-detection.md
/
spec-update-summary.md
/
documentation-changelog.md
从0→1重新同步并升级为正式未分配任务规范文档的操作流程
v10.08.562026-03-11反映TASK-UI-04C的重新审计经验: 在
references/phase12-checklist-definition.md
/
references/phase-11-12-guide.md
/
references/patterns.md
中添加,从已完成工作流的
phase-12-documentation.md
outputs/phase-12
中移除「仅制定规范」等计划表述的防护规则,将实际结果同步与
[x]
更新升级为Phase 12完成条件
v10.08.552026-03-11反映TASK-UI-04C-WORKSPACE-PREVIEW的Phase 12完成同步: 将当前工作流的
index.md
/
artifacts.json
/
phase-1..12
状态 /
outputs/verification-report.md
同步至已完成实际结果,明确将
validate-phase11-screenshot-coverage
/
validate-phase12-implementation-guide
/
verify-unassigned-links
/
audit-unassigned-tasks --diff-from HEAD
作为Phase 12完成门控
v10.08.542026-03-11反映TASK-UI-04B-WORKSPACE-CHAT的Phase 12重新审计: 将
implementation-guide.md
调整为符合验证器要求(Part 2的TypeScript类型 / API签名 / 使用示例 / 错误处理 / 边缘场景 / 配置与常量),在
phase-11-manual-test.md
中补充屏幕覆盖矩阵。明确将
validate-phase12-implementation-guide
validate-phase11-screenshot-coverage
警告消除作为完成门控
v10.08.532026-03-11反映TASK-FIX-LIGHT-THEME-TOKEN-FOUNDATION-001的已完成工作流待办项位置: 将Phase 12任务4的正本位置规则明确为「来自活跃工作流的存放于
docs/30-workflows/unassigned-task/
,来自已完成工作流的存放于
docs/30-workflows/completed-tasks/<workflow>/unassigned-task/
」,将
audit-unassigned-tasks --json --diff-from HEAD --unassigned-dir <dir> --target-file <file>
添加至完成门控
v10.08.522026-03-11反映TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001的重新确认经验: 在
references/unassigned-task-guidelines.md
中添加「指定目录位置检查(本次差异位置 / 当前判定 / 遗留基准)」的3行模板。明确
currentViolations=0
baselineViolations>0
的区分报告规则,防止Phase 12重新审计时的未分配任务误判
v10.08.512026-03-11反映TASK-FIX-APIKEY-CHAT-TOOL-INTEGRATION-001的Phase 11/12重新审计: 在Phase 11中通过
capture-task-fix-apikey-chat-tool-integration-phase11.mjs
重新拍摄TC-11-01..03并执行Apple UI/UX视觉验证。在Phase 12中补充5项必选成果物的缺失,将
phase-12-documentation.md
调整为符合任务12-1〜12-5的结构。将
artifacts.json
/
outputs/artifacts.json
同步、
validate-phase11-screenshot-coverage
/
validate-phase12-implementation-guide
固定为完成门控
v10.08.502026-03-11添加将用户指定正本作为Phase 12防护的规则: 在
references/phase12-checklist-definition.md
references/phase-11-12-guide.md
中添加,将
.claude/skills/...
等用户指定正本作为标准正本,确保与
.agents/skills/...
等镜像正本无偏移的完成条件
v10.08.492026-03-11修正TASK-UI-07重新审计中发现的标准路径偏移: 强化
references/spec-update-workflow.md
的用户指定正本标准,补充Phase 12完成时需同时保留标准正本 / 镜像正本 / 偏移记录的操作流程至变更历史
v10.08.482026-03-11反映TASK-UI-08-NOTIFICATION-CENTER的Phase 11重新审计补充: 将
validate-phase11-screenshot-coverage
纳入完成门控,补充
phase-11-manual-test.md
测试用例
/
屏幕覆盖矩阵
manual-test-result.md
证据
列需保持字面量的操作流程至变更历史
v10.08.472026-03-11反映TASK-UI-08-NOTIFICATION-CENTER的Phase 12完成同步: 补充
outputs/phase-12
的5项成果物与工作流根文档(
index.md
/ 可追溯性 / 差异反映 / 验证报告)需在同一周期内同步,不遗留仅规范过时内容的操作流程至变更历史
v10.08.482026-03-11强化TASK-SKILL-LIFECYCLE-01的Phase 12未分配任务0件报告: 在
references/unassigned-task-guidelines.md
中添加
currentViolations=0
baselineViolations>0
时的推荐表述示例,明确分离「本次差异」与「目录基准」的规则。将
assets/phase12-task-spec-compliance-template.md
更新为添加遗留基准与现有修复任务记录栏的模板,确保即使0件报告也不会丢失待办项导航
v10.08.472026-03-11反映TASK-SKILL-LIFECYCLE-01的重新审计经验: 在
references/phase-11-12-guide.md
中添加代表性截图优先基于选择器的元素捕获而非shell全景的规则。将
data-testid
或实际文本作为就绪选择器的标准,明确在工作流
screenshot-plan.json
中保留选择器的复用模式
v10.08.462026-03-10反映TASK-UI-06-HISTORY-SEARCH-VIEW的Phase 12重新审计经验: 在
references/spec-update-workflow.md
中添加「
.claude
为标准正本,
.agents
为镜像」规则,在
references/patterns.md
中添加Phase 12的技能根目录混淆模式。补充防止工作流 / 输出内容将
.agents/skills/.../references/
作为正本参考的重新审计步骤,以及将未分配任务
UT-IMP-SKILL-ROOT-CANONICAL-SYNC-GUARD-001
标准化的操作流程
v10.08.452026-03-10反映TASK-UI-03 Phase 12重新审计的待办项对齐: 将当前分支已解决的
UT-UI-03-TYPE-ASSERTION-001
规范化至已完成未分配任务,将Phase 11浅色主题发现转化为
UT-UI-03-LIGHT-SECONDARY-TEXT-CONTRAST-001
并以任务规范格式标准化的操作流程添加至变更历史。标准化
unassigned-task-detection.md
/
task-workflow.md
/
spec-update-summary.md
的等值同步
v10.08.442026-03-10修正TASK-UI-03重新审计中task-specification-creator的标准脚本路径: 将当前工作流 /
commands.md
/
phase-11-12-guide.md
/
phase-templates.md
/
patterns.md
/
unassigned-task-guidelines.md
中原本指向
.claude/skills/task-specification-creator/scripts/
的引用统一为
.agents/skills/task-specification-creator/scripts/
,重新对齐
validate-phase-output.js
的位置参数契约
v10.08.432026-03-10同步TASK-UI-03当前工作流: 将Phase 11的专用测试 harness 路由与
manual-test-result.md
/
screenshot-plan.json
/
screenshot-coverage.md
的TC证据结构反映至当前工作流实际结果,补充Phase 12中outputs/phase-4〜12与
.claude/skills/...
正本需在同一周期内同步的操作流程至变更历史
v10.08.422026-03-10完成TASK-10A-G: 强化技能生命周期集成测试(G1:14项IPC契约 + G2:21项Store驱动 + G3:17项ChatPanel接线 = 52项测试全部通过)。更新arch-state-management.md的关联任务状态,添加task-workflow.md的已完成任务。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25的应对措施)
v10.08.412026-03-10TASK-FIX-SAFEINVOKE-TIMEOUT-001 技能改进: 在Phase 4模板中添加P13计时器测试注意事项(必须使用advanceTimersByTime、验证清理、假计时器作用域管理)。在Phase 5模板中添加P13陷阱行和DRY集成模式(重复实现的公共实用工具提取步骤)。在Phase 7模板中添加小型实用工具100%覆盖率达成模式。在patterns.md中添加Preload IPC超时模式2项(Promise.race超时、清理验证测试)
v10.08.402026-03-10反映TASK-FIX-SAFEINVOKE-TIMEOUT-001的重新审计操作流程: 补充Phase 12中不遗留「计划在PR合并时执行」的记录,需当场同步
.claude/skills/...
正本・
SKILL.md
/
LOGS.md
・工作流输出内容的规则。同时补充超时任务需将
cleanup
测试纳入验收条件、明确要求截图时即使非UI任务也需捕获影响UI的代表性内容的固定操作流程
v10.08.392026-03-10反映TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001的重新审计操作流程: 补充明确要求截图时不使用P53替代方案,需完成专用测试harness路由 +
screenshot-plan.json
+ 捕获元数据 +
validate-phase11-screenshot-coverage
的操作流程。同时补充bypass视图需将重置排除条件纳入规范的规则,以及工作树预检查
pnpm install --frozen-lockfile
v10.08.382026-03-09同步TASK-FIX-AUTHGUARD-TIMEOUT-SETTINGS-BYPASS-001的完成: 在
architecture-auth-security.md
中添加认证状态迁移「timed-out」、Settings bypass安全记录。在
arch-state-management.md
中添加AUTH_TIMEOUT_MS超时机制记录。在
ui-ux-navigation.md
中添加Settings的AuthGuard外部访问记录。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25的应对措施)
v10.08.392026-03-10反映TASK-UI-04A-WORKSPACE-LAYOUT的工作树截图操作流程: 在
phase-11-12-guide.md
中添加「多工作树中预览源不稳定时,静态分发当前构建
out/renderer
」的规则。补充重新审计标准步骤:当前工作流的Phase 4-12成果物补充、重新获取8张截图、通过
audit-unassigned-tasks --diff-from HEAD
确认current=0
v10.08.382026-03-09补充TASK-FIX-APP-DEBUG-LOCALSTORAGE-CLEAR-001的截图规则: 在
phase-11-12-guide.md
中添加「持久化Bug需分离Bug路径验证(常规路由元数据)与截图路径(专用测试harness),不将
skipAuth=true
作为唯一路径」的操作流程。同时补充当前工作流过时状态 / 占位符移除与未分配任务标准化的重新审计步骤
v10.08.372026-03-09明确未分配任务指示书的差异审计时机: 在
references/unassigned-task-guidelines.md
中添加「新创建/全面更新的未分配任务指示书,需在创建后立即执行
audit-unassigned-tasks --json --diff-from HEAD --target-file <file>
,直至
currentViolations=0
」的规则。强化分离位置合规与模板合规的判定操作流程
v10.08.362026-03-09反映TASK-FIX-CONCURRENCY-GUARD的反馈: 在Phase 4测试规范中标准添加单体仓库测试执行目录注意事项(P40)。在Phase 2设计模板中添加「考虑并发执行防护」检查点
v10.08.352026-03-09反映TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001的重新审计补充: 从模板 / 指南 / Agent文档中移除
validate-phase-output
的错误CLI示例(
--phase
),在
phase-11-12-guide.md
中添加「BrowserRouter下的测试harness不重复使用Router」的规则。强化以重新同步workflow12的Phase 11截图 / Phase 12实现指南为前提的操作流程
v10.08.342026-03-09同步TASK-FIX-AGENT-EXECUTE-SKILL-CONCURRENCY-GUARD-001的完成: 在
arch-state-management.md
中添加executeSkill并发执行防护模式记录。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25的应对措施)。检测到2项未分配任务
v10.08.332026-03-08补充TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001的难点: 通过skill-creator优化模板 + 在4份规范文档中记录难点
v10.08.322026-03-08同步TASK-FIX-IPC-HANDLER-GRACEFUL-DEGRADATION-001的规范: 在
api-ipc-system.md
/
architecture-implementation-patterns.md
/
security-electron-ipc.md
/
task-workflow.md
中同步Graceful Degradation完成记录。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25的应对措施)
v10.08.312026-03-08强化TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001のPhase 12完成条件: 在
references/phase-11-12-guide.md
中添加将
phase-12-documentation.md
的任务1-5 / 步骤1-A〜3 / 完成条件检查同步至实际结果的要求,以及系统规范更新时需在领域规范侧留下
实现内容 / 难点 / 5分钟卡片
或等效经验教训参考的条件。强化Phase 12不仅以成果物存在为完成判定的操作流程
v10.08.302026-03-08反映workflow12重新确认操作流程: 在
references/phase-11-12-guide.md
中添加「App shell迁移不稳定时,可优先使用直接渲染同一视图的测试harness路由」的记录。固定workflow12将
TC-11-UI-01..03
截图,
测试用例
,
屏幕覆盖矩阵
, 后续问题登记作为一整套操作流程
v10.08.292026-03-08同步TASK-FIX-SUPABASE-FALLBACK-PROFILE-AVATAR-001的完成: 在
api-ipc-auth.md
中添加Profile/Avatar fallback处理程序完成任务章节。在
error-handling.md
中添加变更历史。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25的应对措施)
v10.08.282026-03-08补充TASK-10A-F Phase 12任务规范重新确认的操作流程: 在
references/phase-11-12-guide.md
中添加比较基准的已完成工作流也需通过
verify-all-specs --strict
/
validate-phase-output
后再进行分支判定的步骤。在
references/unassigned-task-guidelines.md
中添加
currentViolations=0
baselineViolations>0
的双层报告规则,以及分离记录「已放置于指定目录」与「目录整体健全化」的操作流程
v10.08.272026-03-08反映TASK-10A-F最终同步: 补充不仅同步当前工作流的Phase 11/12,比较基准的已完成工作流也需在同一周期内标准化至通过
verify-all-specs --strict
/
validate-phase-output
的操作流程至变更历史。同时将
capture-skill-analysis-view-screenshots.mjs
data-testid
就绪选择器化、
capture-skill-create-wizard-screenshots.mjs
的Store来源 fallback 文本等待、
phase-12-documentation.md
步骤1-D的
generate-index.js
路径修正升级为重新审计标准步骤
v10.08.262026-03-08反映TASK-10A-F当前工作流重新审计的操作流程漏洞: 在
SKILL.md
中添加
evidence-sync-rules.md
/
screenshot-verification-procedure.md
/
phase12-checklist-definition.md
的直接链接,消除Phase 11/12的导航不足。同时将命令示例统一为标准路径,明确防止变更历史版本重复的编号检查规则
v10.08.252026-03-08同步TASK-10A-E-D/TASK-UI-03/TASK-10A-F的规范: 通过6个并行SubAgent将5项经验教训・5种模式・5项已完成任务・5项未分配任务同步至规范文档正本。同时更新lessons-learned/arch-state-management/task-workflow/patterns/LOGS/SKILL。通过4份文件同时更新应对P1/P25
v10.08.242026-03-07反映TASK-10A-F的重新确认: 基于用户要求的屏幕验证重新执行
SCREENSHOT
必选操作流程,将
store-driven-lifecycle-ui
的Phase 11证据更新至11件。补充Phase 12的缺失成果物(
unassigned-task-detection.md
/
skill-feedback-report.md
/
spec-update-summary.md
),补充在同一周期内完成步骤1-A〜步骤2实际更新的操作流程
v10.08.242026-03-08完成跨分支Phase 12重新审计 + 持久化可迭代对象强化规范同步: 在
arch-state-management.md
中添加持久化恢复契约(DD-01〜DD-03),在
lessons-learned.md
中添加代码示例与关联陷阱参考,在
task-workflow.md
中添加已完成任务和5个解决方案卡片,在
skill-creator/references/patterns.md
中添加持久化3层防护 + 跨分支审计模式。通过5个并行SubAgent同时更新4份规范文档
v10.08.232026-03-07将TASK-10A-E-C的实现经验转化为系统规范资产: 在
architecture-implementation-patterns.md
中添加S18,在
lessons-learned.md
中添加3项难点,在
06-known-pitfalls.md
中添加P48。431项测试全部通过,将Phase 1-12完成的实现结果反映至4份文件(2份LOGS.md + 2份SKILL.md)
v10.08.222026-03-06反映TASK-10A-E-CのPhase 12重新确认模板适配: 补充重新审计步骤:同步
phase-12-documentation.md
的完成检查、将
documentation-changelog.md
更新为实际内容、将2项未分配任务适配9个标题模板。标准化同时执行
validate-phase11-screenshot-coverage
audit --target-file
的操作流程
v10.08.212026-03-06反映TASK-10A-E-CのPhase 11/12操作流程: 将
manual-test-result.md
更新为
TC-ID + 证据
格式,添加
validate-phase11-screenshot-coverage
通过expected=8/covered=8的证据设计。将
spec-update-summary.md
的「仅计划更新」表述替换为实际更新结果,将2项未分配任务的3步骤登记(指示书创建/台账同步/关联规范参考)反映至标准步骤
v10.08.202026-03-06反映TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001重新审计的操作流程漏洞: 在
references/phase-11-12-guide.md
中添加使用专用测试harness重新拍摄Phase 11截图的条件、
phase11-capture-metadata.json
manual-test-result.md
的同步、
屏幕覆盖矩阵
测试用例
列必选规则。在
references/spec-update-workflow.md
中添加IPC传输契约变更时需检查
references/ipc-contract-checklist.md
/
indexes/quick-reference.md
的跨文档更新规则
v10.08.192026-03-06反映TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001のPhase 1-12执行: 执行
docs/30-workflows/completed-tasks/03-TASK-FIX-AUTH-MODE-CONTRACT-ALIGNMENT-001
的Phase 1〜12,固定Phase 11的
TC-11-01..05
截图5件与Apple UI/UX视觉验证作为必选证据。记录Phase 12的标准操作流程:生成6项成果物、通过
complete-phase.js
同步台账、对齐
artifacts.json
/
outputs/artifacts.json
、同步
phase-1..12*.md
的completed状态、修复
verify-unassigned-links
的失效链接、重新执行
verify-all-specs
/
validate-phase-output
/
validate-phase11-screenshot-coverage
v10.08.182026-03-06添加Phase 12合规检查与父规范参考防护: 新建
assets/phase12-task-spec-compliance-template.md
,添加将任务12-1〜12-5 / 步骤1-A〜1-G / 步骤2的判定集中至单个文件的模板。同时更新
scripts/verify-all-specs.js
,将
task-*.md
/
../task-*.md
的参考存在性纳入验证范围,实现自动检测父规范桥接缺失
v10.08.172026-03-06反映TASK-043B重新审计的导航修复规则: 在
references/phase-11-12-guide.md
中添加
TC-xx
本体证据与
VIS-xx
辅助证据的分离操作流程,在
references/spec-update-workflow.md
中添加
../task-xxx.md
父规范参考的桥接检查。明确Phase 12需同时确认工作流目录与父规范文件存在性的步骤
v10.08.162026-03-06反映TASK-043BのPhase 11/12执行经验: 补充
manual-test-result.md
TC-ID + 证据 + 非视觉日志
格式、辅助截图警告的处理方式、
validate-phase11-screenshot-coverage
基于9个TC通过的操作流程至LOGS
v10.08.212026-03-07添加TASK-UI-03 Phase 4无障碍测试推荐: 在
references/phase-templates.md
的Phase 4模板中添加无障碍测试(WCAG 2.1 AA)推荐章节。标准化UI任务在Phase 4早期从ARIA标签 / 角色属性 / 键盘操作 / 对比度 / 状态通知这5个维度设计测试用例。依据:TASK-UI-03中直至Phase 10才检测到无障碍属性不足,导致4项未分配任务的经验教训
v10.08.202026-03-07反映TASK-UI-03的技能反馈改进: 在Phase 2模板中为UI任务添加「z-index管理表」章节(条件式)。在Phase 12模板步骤1-C中添加关联任务搜索命令示例,强化自动化提示
v10.08.192026-03-07反映TASK-UI-03-AGENT-VIEW-ENHANCEMENT的Phase 12完成: 创建AI助手界面重设计(Tap & Discover)的实现指南・组件文档・4项未分配任务・技能反馈报告。同时更新2份LOGS.md + 2份SKILL.md(针对P1/P25/P29的应对措施)
v10.08.182026-03-06反映TASK-UI-02重新审计的工作流内容过时修正: 在
references/phase-11-12-guide.md
references/spec-update-workflow.md
中添加「即使
artifacts.json
/
index.md
为completed状态,也需确认
phase-1..11
内容规范文档中无
pending
残留」的检查。将Phase 12完成判定扩展至「成果物 / 台账 / 内容规范文档」的三层同步
v10.08.172026-03-06补充TASK-UI-02 Phase 12重新对齐步骤: 在
references/phase-11-12-guide.md
references/spec-update-workflow.md
中添加
outputs/artifacts.json
同步后执行
generate-index.js --workflow ... --regenerate
index.md
状态确认的步骤,防止成果物已完成但工作流索引仍过时的复发
v10.08.162026-03-06反映TASK-UI-02重新审计的操作经验: 在
SKILL.md
中添加
screenshot-verification-procedure.md
/
phase12-checklist-definition.md
/
evidence-sync-rules.md
的直接链接,消除Phase 11/12的导航不足。同时将命令示例统一为标准路径,明确防止变更历史版本重复的编号检查规则
v10.08.172026-03-06添加Phase 12实现指南内容验证器: 添加
validate-phase12-implementation-guide.js
与测试,实现对任务12-1的理由先行 / 日常类比 / TypeScript类型 / API・CLI签名 / 使用示例 / 错误处理 / 配置列表的机械验证。同时将
evidence-sync-rules.md
/
phase12-checklist-definition.md
/
screenshot-verification-procedure.md
接入技能导航
v10.08.162026-03-06反映UT-TASK-10A-B-008重新审计的经验教训: 在
references/phase-11-12-guide.md
中添加「用户明确要求截图验证时,不可仅使用
NON_VISUAL
」「就绪判定使用loaded-state选择器而非root」「浅色证据需使主题模拟跟随拍摄场景」的规则。同时将相同条件添加至Phase 12的遗漏模式
| v10.08.15 | 2026-03-05 | 反映TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001重新确认中发现的Phase 12台账偏移应对措施: 在
references/phase-11-12-guide.md
的任务3.5和完成检查中添加「
phase-12-documentation.md
必须同时满足
状态=completed
和检查表同步」的要求。明确不仅以成果物实体为完成判定的操作流程 | | v10.08.14 | 2026-03-05 | 反映TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001的重新审计: 基于用户追加要求,在Phase 11中重新拍摄3张屏幕回归截图并将证据重新存入工作流根目录,将
manual-test-result.md
更新为
TC + 证据
格式。同时将规范文档的DI签名旧表述同步至当前实现,补充重新执行
validate-phase11-screenshot-coverage
的操作流程 | | v10.08.13 | 2026-03-05 | 反映TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001的执行: 完成
docs/30-workflows/02-TASK-FIX-SKILL-EXECUTOR-AUTHKEY-DI-001
的Phase 1〜12。记录作为任务12步骤1-A/1-B/1-C的
interfaces-agent-sdk-executor.md
/
api-ipc-system.md
的已完成任务・实现状态・关联任务同步,以及按阶段执行
verify-all-specs
/
validate-phase-output
/
complete-phase
的操作流程 | | v10.08.12 | 2026-03-05 | 反映TASK-UI-01-C的重新审计(Phase/索引对齐 + Phase 11实际屏幕证据): 添加修正
artifacts.json
为completed但
index.md
/
phase-1..10
仍残留pending的偏移的操作流程。固定重新审计步骤:通过
apps/desktop/scripts/capture-task-056c-notification-history-screenshots.mjs
重新获取
TC-11-01..03
,将
manual-test-result
/
evidence-index
/
screenshot-matrix
更新为
SCREENSHOT + NON_VISUAL
组合格式 | | v10.08.12 | 2026-03-05 | 反映TASK-FIX-AUTH-KEY-HANDLER-REGISTRATION-001重新审计的Phase 11 TC覆盖率修正: 应用
phase-11-manual-test.md
测试用例
/
屏幕覆盖矩阵
必选规则,将
manual-test-result.md
修正为
TC + 证据
格式。同步
validate-phase11-screenshot-coverage
(3/3)PASS至Phase 12成果物,添加
quick_validate
警告分类(需监控/需处理)记录 | | v10.08.11 | 2026-03-05 | 明确未分配任务审计的
--target-file
适用边界
: 在
references/unassigned-task-guidelines.md
中添加「
--target-file
仅可指定
docs/30-workflows/unassigned-task/
下的文件」「
outputs/phase-12/*.md
审计使用
--diff-from HEAD
」的规则,预防Phase 12重新审计时的命令误用 | | v10.08.10 | 2026-03-05 | 明确Phase 11 TC-ID验证: 在
references/phase-11-12-guide.md
中添加「仅
MT-xx
等场景ID不属于覆盖率验证对象」「必须同时记录
TC-xx
」的规则,添加通过
rg
提前确认TC可提取性的步骤。预防
validate-phase11-screenshot-coverage
的遗漏(预期TC=0) | | v10.08.9 | 2026-03-05 | 反映UT-TASK-10A-B-001最终重新审计(未分配任务位置修正): 将Phase 12的未分配任务审计更新至最新值(
verify-unassigned-links
102/102、
audit --json
current=90、
audit --diff-from HEAD
current=0 baseline=90)。记录已完成指示书(001)存放于
completed-tasks
根目录、未执行指示书(002〜008)存放于
unassigned-task
的操作流程,补充在11:00 JST重新获取5张截图的视觉验证日志与3项成果物(
spec-update-summary
/
documentation-changelog
/
unassigned-task-detection
)同步 | | v10.08.8 | 2026-03-05 | 反映UT-TASK-10A-B-001的重新审计补充: 强化Phase 11的浅色/深色证据对齐检查,将
capture-ut-task-10a-b-001-screenshots.mjs
的主题模拟修正为跟随
prefers-color-scheme
。补充在
documentation-changelog.md
/
unassigned-task-detection.md
中记录
--target-file
审计与截图覆盖率(5/5)的操作流程 | | v10.08.7 | 2026-03-05 | 反映UT-TASK-10A-B-001的Phase 1-12执行: 将UI追加任务的执行结果(Red→Green、53项测试通过、目标覆盖率 100/96.22/100、Phase 11截图5件)添加至操作记录。记录标准步骤:生成
outputs/phase-1
phase-12
成果物并同步
artifacts.json
、反映步骤1-A〜1-G执行日志 | | v10.08.6 | 2026-03-04 | 添加Phase 11证据工作流位置偏移应对措施至指南: 在
references/phase-11-12-guide.md
中添加「证据必须存放于目标工作流的
outputs/phase-11/screenshots
」「非视觉TC必须使用
NON_VISUAL:
记法」的规则。将相同条件添加至Phase 12检查表,预防
validate-phase11-screenshot-coverage
失败(仅参考其他工作流)复发 | | v10.08.5 | 2026-03-04 | 添加UI重新拍摄的Port 5174冲突防护至Phase 11/12指南: 在
references/phase-11-12-guide.md
的预览预检查中添加
lsof -nP -iTCP:5174 -sTCP:LISTEN
,明确
Port 5174 is already in use
发生时的分支(停止/复用)需记录至
spec-update-summary.md
的完成条件。同步至自动化命令和检查表 | | v10.08.4 | 2026-03-04 | 添加Phase 12步骤1-C(关联任务表完成同步)至重新确认操作流程: 以
UT-IMP-PHASE12-SCREENSHOT-COMMAND-REGISTRATION-GUARD-001
为对象,记录修正示例:将
ui-ux-feature-components.md
的关联未分配任务表、未分配任务指示书、问题的3项状态在同一周期内完成化。明确完成状态条件为「状态更新 + 检查表同步 + 完成备注」 | | v10.08.3 | 2026-03-04 | 反映TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001的第二次重新确认: 将
outputs/phase-11
的屏幕证据时间更新为16:50 JST,统一拍摄命令为
capture-skill-center-metadata-guard-screenshots.mjs
。将
spec-update-summary.md
/
unassigned-task-detection.md
/
documentation-changelog.md
的重新审计值同步至
verify-unassigned-links
88/88、
audit --diff-from HEAD
baseline=94,将
phase-12-documentation.md
的移交事项更新为已完成移交 | | v10.08.2 | 2026-03-04 | 标准化SkillCenter重新审计的UI重新拍摄预检查: 在
references/phase-11-12-guide.md
中添加重新拍摄前的
preview preflight
(构建成功 +
127.0.0.1:4173
连通性检查)。失败时记录至
unassigned-task-detection.md
,并将分支为
docs/30-workflows/unassigned-task/
未分配任务化的规则添加至完成条件检查 | | v10.08.1 | 2026-03-04 | 固定TASK-FIX-SKILL-CENTER-METADATA-DEFENSIVE-GUARD-001的重新审计: 按顺序对Phase 1〜12应用
complete-phase.js
,同步
artifacts.json
completed
,生成
outputs/artifacts.json
。重新执行
generate-index
(2个技能)+
verify-all-specs
(13/13)+
validate-phase-output
(28项)+
validate-phase11-screenshot-coverage
(4/4)+
verify-unassigned-links
(88/88),固定重新审计证据 | | v10.08.0 | 2026-03-04 | 反映TASK-FIX-SKILL-IMPORT三次连续修正的重新审计: 重新审计
01/02/03
工作流,将实现内容和难点同步至
aiworkflow-requirements
正本6份规范文档(api-ipc/interfaces/arch-state/ui-ux-feature/task-workflow/lessons)。记录Phase 12任务5必选的4份文件(
LOGS.md
x2 +
SKILL.md
x2)需在同一周期内更新,固定
verify-all-specs
(3个工作流)/
validate-phase-output
(3个工作流)/
validate-phase11-screenshot-coverage
(工作流03)/
audit --diff-from HEAD
的证据 | | v10.07.1 | 2026-03-03 | TASK-10A-D重新审计补充: 修正Phase 11证据不足,在
outputs/phase-11/screenshots/
中添加TC-01〜TC-05。将
manual-test-result.md
更新为带证据列,使
validate-phase11-screenshot-coverage
通过。修复
task-workflow.md
的3项未分配任务链接,使
verify-unassigned-links
恢复为
ALL_LINKS_EXIST
。重新同步
artifacts.json
index.md
,将Phase 13对齐为
pending
(未执行) | | v10.07.0 | 2026-03-03 | 同步TASK-10A-D的Phase 12完成: 将实现内容和3项难点(Suggestion类型不一致、P40复发、P11模式)同步至
ui-ux-components.md
/
ui-ux-feature-components.md
/
arch-ui-components.md
/
arch-state-management.md
/
interfaces-agent-sdk-skill.md
/
task-workflow.md
。同时更新2份LOGS.md・2份SKILL.md(针对P1/P25/P29的应对措施)。按P43合规要求拆分至3份文件以下/Agent执行 | | v10.06.0 | 2026-03-02 | 反映TASK-10A-C的重新审计模式: 在
phase-11-manual-test.md
/
phase-12-documentation.md
中添加必须补充依赖Phase成果物(2/5/6/7/8/9/10)参考资料的规则,补充消除
verify-all-specs
依赖参考警告的操作流程。UI任务需通过
screenshot:*
重新执行固定证据新鲜度,明确将步骤1-A的LOGS/SKILL 4份文件同时更新作为完成条件 | | v10.05.0 | 2026-03-02 | 强化Phase 13 PR内容章节联动: 在
phase-templates.md
的Phase 13中添加与
/ai:diff-to-pr
Phase 3.6(
TARGET_WORKFLOW_DIR
识别)的联动规则,将PR内容同步至
.github/pull_request_template.md
合规章节。添加UI/UX变更时自动将
outputs/phase-11/screenshots/*.png
插入PR内容
## 截图
的要求。在
phase-11-12-guide.md
完成检查中添加「Phase 13确认目标工作流」「
## 其他
反映Phase 12实现指南」检查项 | | v10.04.0 | 2026-03-02 | 改进Phase 11屏幕覆盖矩阵: 在
phase-templates.md
中添加屏幕覆盖矩阵(4步骤: 识别变更组件/定义UI状态覆盖率/创建拍摄计划JSON/生成覆盖率报告)。将
phase-11-12-guide.md
的执行流程扩展至9步骤,将拍摄命令重新组织为A.计划批量拍摄/B.单独拍摄的2种结构。更新
capture-screenshots.js
为扩展版(添加--plan/--selector/--action/--action-target/--help选项、按主题分组、自动生成覆盖率报告) | | v10.05.0 | 2026-03-02 | 反映TASK-10A-B的Phase 11/12重新审计: 在
phase-11-manual-test.md
中添加必选章节「集成测试联动」,将
manual-test-result.md
更新为基于实际截图证据。将
unassigned-task-detection.md
从7件→5件重新同步。将
verify-all-specs
警告从13→0,将
validate-phase-output
恢复为28项通过 | | v10.04.0 | 2026-03-02 | 反映TASK-10A-B SkillAnalysisView的实现完成: Phase 1-12全部完成(72项测试全部通过,覆盖率 行100%/分支95.83%/函数100%)。同时更新2份LOGS.md・2份SKILL.md,重新生成topic-map.md。更新
docs/30-workflows/completed-tasks/skill-analysis-view/outputs/phase-12/spec-update-summary.md
| | v10.03.0 | 2026-03-02 | 反映Phase 12合规重新确认的执行模式: 在
skill-editor-view
TASK-UI-05
的2个工作流中同时执行
verify-all-specs
/
validate-phase-output
,确立在同一周期内核对任务1/3/4/5成果物实体・implementation-guide Part 1/2・未分配任务10个标题的操作流程。将未分配任务审计的合格标准固定为
currentViolations=0
| | v10.02.0 | 2026-03-02 | TASK-UI-05A重新审计(Phase 11/12对齐修正): 向
outputs/phase-11
补充2026-03-02重新获取的截图(Dashboard/Editor/导航检查)。添加
outputs/phase-12/spec-update-summary.md
,反映3项未分配任务正本(
docs/30-workflows/unassigned-task/
)与
artifacts.json
/
outputs/artifacts.json
的同步 | | v10.01.0 | 2026-03-01 | TASK-UI-05A全面审计・规范修正反映: 在Phase 1/2/4/5中添加skill:getFileTree IPC通道,将useFileTree参数规范统一为基于skillName。反映UT-UI-05A-GETFILETREE-001未分配任务登记 | | v10.00.0 | 2026-03-01 | 反映TASK-UI-05A spec_created重新审计: 在Phase 12操作流程中明确「屏幕验证截图必选」,补充同步证据(Dashboard/Editor截图、manual-test-result、discovered-issues)至
docs/30-workflows/skill-editor-view/outputs/phase-11/
的步骤。同时反映修正已完成任务移管后链接偏移导致
verify-unassigned-links
失败的操作流程 | | v10.02.0 | 2026-03-02 | 反映TASK-UI-05B实现完成重新审计: 重新审计
docs/30-workflows/skill-advanced-views
,将
spec_created
残留同步至
completed
。添加Phase 11屏幕证据(TC-04〜TC-07)。将
phase-12-documentation.md
修正为符合模板(
执行任务
/
参考资料
/
成果物
/
完成条件
),将
verify-all-specs
(13/13)/
validate-phase-output
(28项)恢复为通过。完成Phase 12步骤1-A的
SKILL.md
/
LOGS.md
4份文件同步 | | v10.01.0-v9.97.0 | 2026-03-01〜2026-02-28 | Phase 12完成同步与重新审计规则整理: 逐步整理
artifacts.json
/
outputs/artifacts.json
/
index.md
/
phase-1..12
同步、必选成果物实体确认、
validate-phase-output
/
verify-all-specs
/
verify-unassigned-links
/ 截图覆盖率的完成门控化。详情参考
LOGS.md
| | v9.96.0-v9.92.2 | 2026-02-27〜2026-02-25 | Phase 12防护与quick_validate操作流程标准化: 整理未分配任务审计、父规范参考对齐、已完成任务移管、
quick_validate.js
路径统一、skill-creator联动、
## 元数据
重复防止等复发防止规则。详情参考
LOGS.md
| | v9.92.1 | 2026-02-25 | 改进历史操作: 将
SKILL.md
的变更历史整理为以近期为中心,符合结构验证(500行上限)。统一长期详细历史以
LOGS.md
为正本参考的方针 | | v9.92.0 | 2026-02-25 | 同步UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001的重新审计: 将
references/spec-update-workflow.md
的baseline/current判定步骤更新为基于
--target-file
/
--diff-from
| | v9.91.0 | 2026-02-25 | 反映UT-IMP-UNASSIGNED-AUDIT-SCOPE-CONTROL-001的实现: 在
scripts/audit-unassigned-tasks.js
中添加
--target-file
/
--diff-from
currentViolations
/
baselineViolations
分离、范围化判定 | | v9.90.0 | 2026-02-25 | 反映UT-IPC-AUTH-HANDLE-DUPLICATE-001的重新确认: 在
phase-11-12-guide.md
/
spec-update-workflow.md
中添加技能结构验证检查(基于
quick_validate.js
) |
补充: v9.89.0以前的历史记录于
LOGS.md
(保留审计证据)。 | v10.09.3 | 2026-03-13 | 强化Phase 12核心证据与拆分感知未分配任务审计: 将
assets/phase12-task-spec-compliance-template.md
扩展为可确认4项核对 / 实现指南必选要素 / current-baseline分离 / 系统规范同步的核心证据格式,改进
scripts/verify-unassigned-links.js
使其在指定父
task-workflow.md
时也扫描同级
sibling task-workflow*.md
。在
references/unassigned-task-guidelines.md
中也补充拆分感知执行前提 | | v10.09.2 | 2026-03-13 | 修正artifacts schema兼容性: 调整
schemas/artifact-definition.json
以匹配当前工作流实体,更新验证器使其兼容遗留字符串成果物数组、Phase
blocked
metadata.taskType=improvement
。在
references/artifact-naming-conventions.md
中也补充对象推荐 / 遗留兼容的操作规则 | | v10.09.1 | 2026-03-13 | 反映TASK-IMP-AIWORKFLOW-REQUIREMENTS-LINE-BUDGET-REFORM-001的重新审计经验:
spec_created
工作流可补充
outputs/phase-12/
的外壳以消除分支级文档偏移,但需将
artifacts.json
currentPhase
作为执行进度正本保留,固定需满足Phase 12检查表细项(实现指南 / 文档变更历史 / 跨技能反馈)的规则 | | v10.09.0 | 2026-03-12 | 反映TASK-IMP-TASK-SPECIFICATION-CREATOR-LINE-BUDGET-REFORM-001: 将
SKILL.md
精简为入口专用,将
patterns
phase-templates
spec-update-workflow
phase-11-12-guide
LOGS.md
重新组织为系列文件与归档。固定标准正本为
.claude
、镜像为
.agents
,整理行数预算 / 直接链接 / 镜像一致性 / 依赖完整性的验证导航 | | v10.08.60 | 2026-03-12 | 反映
UT-IMP-PHASE11-CURRENT-BUILD-PREFLIGHT-BUNDLE-001
规范化 | | v10.08.59 | 2026-03-12 | 添加当前构建静态分发备选方案与skill-creator条件式同步规则 | | v10.08.58 | 2026-03-12 | 补充Apple UI/UX视觉评审与current/baseline分离记法 | | v10.08.57 | 2026-03-11 | 添加事后未分配任务化导致0件→1件重新同步的规则 |
详细历史与使用日志参考LOGS.mdreferences/logs-archive-index.md