Skip to content

Conversation

@unagi
Copy link
Owner

@unagi unagi commented Jan 1, 2026

概要

職務経歴書の品質向上のため、12種の職種別ガイドを追加し、ドキュメント構造を改善しました。

追加内容

職種別ガイド(12種)

職種分類 ファイル 主要観点
企画・マーケティング・管理系 01_planning_marketing_management.md KPI、CVR、CPA
販売・サービス系 02_sales_service.md 売上、客単価、CS
専門サービス系 03_professional_services_medical_welfare_education.md 利用者満足度、時間短縮
専門職系 04_specialist_consulting_finance_real_estate.md ROI、コスト削減
クリエイティブ系 05_creative.md CVR/CTR、制作ツール
エンジニア・IT系 06_engineer_it.md 技術スタック、性能改善
技術系(電気・機械) 07_technical_electrical_mechanical.md CAD/CAE、不良率低減
技術系(建築・土木) 08_technical_arch_civil.md 工期短縮、無事故
技術系(医薬・化学) 09_technical_pharma_chemical_material_food.md 特許、歩留まり改善
管理・事務系 10_administrative_office.md Excel関数、処理時間削減
公務員・自衛官 11_public_servant_sdf.md 災害対応、表彰実績
団体職員・その他 12_organization_staff_others.md 参加率、調整力

ドキュメント構造の整理

skill/references/
├── README.md                           # エンドユーザー向け案内(職種別ガイドへの導線追加)
├── career_sheet_best_practices.md      # 職種非依存の共通原則(職種別ガイドとの連携を明記)
└── job_type/                           # 職種別ガイド(新規追加)
    ├── README.md                       # 職種別ガイド索引
    └── 01-12_*.md                      # 各職種の詳細ガイド

各ガイドの統一構造

すべてのガイドが以下のセクションを持ちます:

  1. 概要
  2. 職務要約で強調するポイント
  3. 職務経歴で必須の具体情報
  4. 成果指標の例
  5. キーワード辞書
  6. よくあるNG/注意
  7. 追加で確認したい質問
  8. 参考(外部リンク + Agent Skills環境の注記)

変更の理由

課題

  • 職種によって職務経歴書の書き方が大きく異なる
  • 共通原則と職種固有のポイントが混在していた
  • LLMが適切な情報を参照しづらい構造だった

解決策

  • 職種非依存の原則 → career_sheet_best_practices.md
  • 職種固有の深掘り → job_type/*.md
  • 相互参照による情報アクセスの改善

影響範囲

変更ファイル

  • skill/SKILL.md: 職種別ガイドへの参照を追加
  • skill/references/README.md: 職種別ガイドのセクション追加
  • skill/references/career_sheet_best_practices.md: 職種別ガイドとの連携を明記(0章追加)

新規追加

  • skill/references/job_type/README.md: 職種別ガイド索引
  • skill/references/job_type/*.md: 12種の職種別ガイド

破壊的変更

なし(既存機能への影響なし)

テスト計画

  • ドキュメントの相互参照が正しく機能すること
  • Agent Skills環境でオフラインアクセス可能なこと
  • 既存の職務経歴書生成フローに影響がないこと

関連Issue

なし(ドキュメント充実化の一環)

🤖 Generated with Claude Code

## 追加内容

### 職種別ガイド(12種)
- 企画・マーケティング・管理系
- 販売・サービス系
- 専門サービス系(医療・福祉・教育)
- 専門職系(コンサル・金融・不動産)
- クリエイティブ系
- エンジニア・IT系
- 技術系(電気・電子・機械)
- 技術系(建築・土木)
- 技術系(医薬・化学・素材・食品)
- 管理・事務系
- 公務員・自衛官
- 団体職員・その他

### ドキュメント構造の整理
- `career_sheet_best_practices.md`: 職種非依存の共通原則
- `job_type/*.md`: 職種別の深掘りガイド
- 相互参照による情報アクセスの改善

## 変更の理由

職務経歴書の品質向上のため、職種ごとの書き分けポイントを体系化。
共通原則と職種固有の情報を明確に分離し、LLMが適切に参照できる構造に改善。

## 影響範囲

- 既存の`career_sheet_best_practices.md`に職種別ガイドへの導線を追加
- `SKILL.md`と`references/README.md`に索引を追加
- 破壊的変更なし(既存機能への影響なし)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@sonarqubecloud
Copy link

sonarqubecloud bot commented Jan 1, 2026

@unagi unagi merged commit 2e7d369 into main Jan 1, 2026
2 checks passed
@unagi unagi deleted the docs/add-job-type-guides branch January 1, 2026 02:00
@codecov
Copy link

codecov bot commented Jan 1, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.96%. Comparing base (3e80f4a) to head (0748b31).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #28   +/-   ##
=======================================
  Coverage   90.96%   90.96%           
=======================================
  Files          22       22           
  Lines        1936     1936           
=======================================
  Hits         1761     1761           
  Misses        175      175           
Flag Coverage Δ
unittests 90.96% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants